home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / disk / cf606.zip / MANUAL.TXT < prev    next >
Text File  |  1997-08-08  |  217KB  |  4,547 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                      *******************************
  10.                      *                             *
  11.                      *   CMFiler -- Version 6.0    *
  12.                      *                             *
  13.                      *******************************
  14.  
  15.  
  16.  
  17.  
  18.                        SHAREWARE DISK/FILE MANAGER
  19.  
  20.  
  21.                    Copyright 1991-96 Charles F. Martin
  22.  
  23.                       President, NoVaSoft - Member
  24.  
  25.                            3239 Riverview Dr.
  26.  
  27.                      Triangle, VA  22172-1421  USA
  28.  
  29.  
  30.             Phone (703) 221-1471/1833   CompuServe 72130,1400
  31.  
  32.  
  33.                     Internet 72130.1400@compuserve.com
  34.  
  35.  
  36.        Home page: http://ourworld.compuserve.com/homepages/novasoft2
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                 Assembled using Wolfware Assembler WASM Ver 2.22x,
  48.                          (c) 1985-1991 Eric Tauck, Wolfware
  49.  
  50.  
  51.     CMFiler Ver 6.0
  52.     ~~~~~~~~~~~~~~~
  53.  
  54.     FOREWORD:
  55.     ____________________
  56.  
  57.     CONCERNING SHAREWARE AND CMFiler:
  58.  
  59.     Definition of Shareware. . .
  60.  
  61.       Shareware distribution gives users a chance to try software before
  62.     buying it.  If you try a shareware program and continue using it, you
  63.     are expected to register it.  Individual programs differ on details -
  64.     some request registration while others require it, some specify a
  65.     maximum trial period.  With registration, you get anything from the
  66.     simple right to continue using the software to an updated program with
  67.     printed manual.
  68.  
  69.       Copyright laws apply to both shareware and commercial software, and
  70.     the copyright holder retains all rights, with a few specific
  71.     exceptions as stated below.  Shareware authors are accomplished
  72.     programmers, just like commercial authors, and the programs are of
  73.     comparable quality.  (In both cases, there are good programs and bad
  74.     ones!)  The main difference is in the method of distribution.  The
  75.     author specifically grants the right to copy and distribute the
  76.     software, either to all and sundry or to a specific group.  For
  77.     example, some authors require written permission before a commercial
  78.     disk vendor may copy their shareware.
  79.  
  80.       Shareware is a distribution method, not a type of software.  You
  81.     should find software that suits your needs and pocketbook, whether
  82.     it's commercial or shareware.  The shareware system makes fitting your
  83.     needs easier, because you can try before you buy.  And because the
  84.     overhead is low, prices are low also.  Shareware has the ultimate
  85.     money-back guarantee - if you don't use the product, you don't pay for
  86.     it.
  87.  
  88.       CMFiler is a copyrighted shareware program by Charles F. Martin,
  89.     President, NoVaSoft and author member of the Association of Shareware
  90.     Professionals.  The evaluation edition of CMFiler is offered at no
  91.     charge to any potential user for evaluation.  Feel free to share the
  92.     evaluation edition with your friends.  The essence of "user-supported"
  93.  
  94.     software is to provide personal computer users with quality software
  95.     without high prices, and yet to provide incentive for programmers to
  96.     continue to develop new products.
  97.  
  98.  
  99.     Special Thanks. . .
  100.  
  101.     . . .to Nick Capik, Tom Vavoso, Dave Herman, Gene Feaster and Edward
  102.     Mendelson, who found most of the subtle bugs, pushed CMFiler far past
  103.     my expectations, and challenged me to include features that turned out
  104.     to be useful to us all;  to Eric Tauck, who provided an excellent and
  105.     inexpensive Assembly language programming environment, then tailored
  106.     it to my needs, and gave me some inside dope on several undocumented
  107.     DOS features;  and to Wolfgang Stiller, who offered advice on
  108.     CMFiler's self-checking features. Eric Tauck's Wolfware Assembler WASM
  109.     can be had by sending $10 to Eric Tauck, 1304 Deerpass Road, Marengo,
  110.     IL  60152. Wolfgang Stiller's Integrity Master anti-virus and data
  111.     security system can be had by sending $39.50 to Stiller Research, 2625
  112.     Ridgeway St., Tallahassee, FL  32310.
  113.  
  114.  
  115.     Ombudsman Statement:
  116.  
  117.       This program is produced by a member of the Association  of
  118.     Shareware Professionals (ASP). ASP wants to make sure that the
  119.     shareware principle works for you. If you are unable to resolve a
  120.     shareware-related problem with an ASP member by contacting the member
  121.     directly, ASP may be able to help. The ASP Ombudsman can help you
  122.     resolve a dispute or problem with an ASP member, but does not provide
  123.     technical support for members' products. Please write to the ASP
  124.     Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe
  125.     message via CompuServe Mail to ASP Ombudsman 70007,3536.
  126.  
  127.  
  128.     CMFiler Disclaimer . . .
  129.  
  130.       Users of CMFiler must accept this disclaimer of warranty:  CMFiler
  131.     is supplied as-is. The author disclaims all warranties, expressed or
  132.     implied, including, without limitation, the warranties of
  133.     merchantability and of fitness for any purpose. The author assumes no
  134.     liability for damages, direct or consequential, which may result from
  135.     the use of CMFiler.
  136.  
  137.  
  138.                                       ii
  139.  
  140.     CMFiler Ver 6.0
  141.     ~~~~~~~~~~~~~~~
  142.  
  143.     CONTENTS
  144.     ____________________
  145.  
  146.     FOREWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  i
  147.  
  148.     INDEX TO TOPICS AND OPERATIONS:. . . . . . . . . . . . . . . . . Ind-7
  149.  
  150.  
  151.     OVERVIEW:. . . . . . . . . . . . . . . . . . . . . . . . . . . . Ov-17
  152.  
  153.     File Contents . . .                                              Ov-17
  154.     Program Logical and Physical Organization . . .                  Ov-19
  155.     Security Features . . .                                          Ov-21
  156.     Monitor Options . . .                                            Ov-22
  157.     Precautions and Limitations . . .                                Ov-22
  158.     Assumption about User's Familiarity with DOS . . .               Ov-24
  159.     Additional Note for Windows Users . . .                          Ov-24
  160.  
  161.  
  162.     TUTORIAL - Chapter 1: File Handling. . . . . . . . . . . . . . . 1-25
  163.  
  164.     Getting Started , or the "Kernel" and the "Overlay": . . .       1-25
  165.     Rename CMFILER to Spare My Fingers . . .                         1-25
  166.     The Screen . .  .                                                1-27
  167.     The Help Area . . .                                              1-27
  168.     More on the "Modifier Keys". . .                                 1-28
  169.     Two Panels . . .                                                 1-28
  170.     Color Palette . . .                                              1-29
  171.     Alphabetic Case Options . . .                                    1-30
  172.     Cursor Movement . . .                                            1-30
  173.     Switching Drives or Disks . . .                                  1-31
  174.     Subdirectories . . .                                             1-31
  175.     Swapping Panels . . .                                            1-32
  176.     Jump Command . . .                                               1-32
  177.     Path Alias Facility . . .                                        1-33
  178.     Copy Some Files, then Do It with Tags . . .                      1-33
  179.     Tagging, Backing Up . . .                                        1-34
  180.     Moving Files . . .                                               1-35
  181.     Deleting a File . . .                                            1-35
  182.     File Splitter . . .                                              1-36
  183.     The Tagging Convention Expounded on . . .                        1-37
  184.     Renaming a File or a Directory . . .                             1-37
  185.     Some Additional Tagging Options . . .                            1-39
  186.     Copy with Rename . . .                                           1-39
  187.     The Floppy "Filler". . .                                         1-39
  188.     The File Freshener . . .                                         1-40
  189.     Different Ways to Show the Files . . .                           1-40
  190.     The Data Entry Window . . .                                      1-40
  191.     Integer Kilobytes versus Actual File Size . . .                  1-41
  192.     File Attributes . . .                                            1-42
  193.     Changing the Date/Time Stamp of a File . . .                     1-42
  194.     "Alt-Tagging" and Appending . . .                                1-42
  195.     Printing a File . . .                                            1-43
  196.     Making Some Notes About Your Files . . .                         1-44
  197.     Notes in Version 6 and Windows 95 Long Filename Support . . .    1-44
  198.     About Win95 Long Filename Aliases . . .                          1-46
  199.     Printing a Directory Listing . . .                               1-47
  200.     Comparison Mode . . .                                            1-47
  201.     Hide Mode . . .                                                  1-47
  202.     Mask Template . . .                                              1-48
  203.     Displaying System Date and Time . . .                            1-48
  204.     Changing or Adding a Volume Label . . .                          1-48
  205.     Some Safeguards . . .                                            1-48
  206.     Saving User Setup Options . . .                                  1-48
  207.     Help . . .                                                       1-51
  208.     Custom Configurations on Networks . . .                          1-51
  209.     Command Line Parameters . . .                                    1-52
  210.     Formatting Floppy Diskette . . .                                 1-52
  211.     Copying Floppy Diskettes . . .                                   1-53
  212.     Scanning a Diskette Sector-by-Sector . . .                       1-53
  213.     Quitting CF . . .                                                1-54
  214.  
  215.  
  216.     TUTORIAL - Chapter 2: File Viewing and Editing. . . . . . . . .  2-55
  217.  
  218.     Viewing a File . . .                                             2-55
  219.     Record Delimiters . . .                                          2-55
  220.     Information Area . . .                                           2-55
  221.     Line Wrapping  . . .                                             2-56
  222.     Cursor Movement . . .                                            2-56
  223.     Find a String . . .                                              2-57
  224.     Leading and Trailing Blanks in the Data Window . . .             2-57
  225.     Editing a File . . .                                             2-58
  226.     Edit Mode Limitations . . .                                      2-58
  227.     Typeover vs Insert . . .                                         2-58
  228.     Editing a Line . . .                                             2-58
  229.     More on Record Delimiters . . .                                  2-59
  230.     Alt-Keypad and Alt-N . . .                                       2-59
  231.     Changing Case. . .                                               2-59
  232.     Pop-up ASCII Table . . .                                         2-59
  233.     Block Operations . . . or the REAL Power of CF's Editor . . .    2-60
  234.     Marking a Block, and the Copy Buffer . . .                       2-60
  235.     Delete, Copy, Move . . .                                         2-60
  236.     Restoring from Inadvertent Block Deletion  . . .                 2-61
  237.     Sending a Block of Text to the Printer . . .                     2-61
  238.     Replace and Global replace . . .                                 2-61
  239.     Leaving Edit Mode . . .                                          2-62
  240.     Saving File in Mid-Session . . .                                 2-62
  241.     Creating a New File with the Editor . . .                        2-63
  242.     Help . . .                                                       2-63
  243.  
  244.  
  245.     TUTORIAL - Chapter 3: The TREE Functions. . . . . . . . . . . .  3-65
  246.  
  247.     Tree Image Facility . . .                                        3-65
  248.     The Display . . .                                                3-66
  249.     Copying structures . . .                                         3-67
  250.     The "Copy Into" Function . . .                                   3-69
  251.     Moving structures . . .                                          3-70
  252.     Copying Just the Files . . .                                     3-70
  253.     Copying Just the Directory Array . . .                           3-70
  254.     Deleting Structures . . .                                        3-71
  255.     Delete Just the Files . . .                                      3-72
  256.     Show the File List . . .                                         3-72
  257.     Find (Goto) a File . . .                                         3-72
  258.     Goto a Directory . . .                                           3-73
  259.     Find Text . . .                                                  3-74
  260.     Viewing or Editing Files . . .                                   3-74
  261.     Deleting Files from the File List . . .                          3-74
  262.     Print a Hard Copy of the Tree or Found Files . . .               3-75
  263.     Precaution Regarding ~TRASH~ . . .                               3-75
  264.     Help . . .                                                       3-75
  265.     Leaving the Tree Functions . . .                                 3-75
  266.  
  267.  
  268.     TUTORIAL - Chapter 4: Launching User Applications . . . . . . .  4-77
  269.  
  270.     Terminology: User Application as "Child" Program . . .           4-77
  271.     Resident Footprint of CF . . .                                   4-77
  272.     "Shelling" to DOS . . .                                          4-78
  273.     Review of DOS Command Line Structure . . .                       4-78
  274.     Launching a Program from the Main Screen . . .                   4-79
  275.     Immediate Execution . . .                                        4-79
  276.     Execution with Command Tail . . .                                4-79
  277.     Execution with a Single File Name in the Command Tail . . .      4-80
  278.     "Seeding" the Command Tail . . .                                 4-80
  279.     Changing the Command Tail "Seed" Delimiter . . .                 4-81
  280.     Customizing Your User Application File Specifications . . .      4-82
  281.     A Further Execution Option - Instant ZIPping/UNZIPping . . .     4-84
  282.     ZIP a File . . .                                                 4-84
  283.     Now UNZIP a File . . .                                           4-85
  284.     Tailoring CF for custom ZIP/UNZIP spec . . .                     4-85
  285.     Using Other Compression Utilities . . .                          4-89
  286.     Specifying a Password for Access from Screen Saver . . .         4-87
  287.  
  288.  
  289.     REFERENCE - Description by Operation . . . . . . . . . . . . .Op-Ref-89
  290.  
  291.     DISK/DIRECTORY OPERATIONS:                                    Op-Ref-89
  292.     FILE OPERATIONS:                                              Op-Ref-90
  293.     FILE EDITING/VIEWING:                                         Op-Ref-93
  294.     TREE OPERATIONS:                                              Op-Ref-94
  295.     APPLICATION LAUNCHING (CHILD PROCESSES):                      Op-Ref-96
  296.     DISPLAY ENHANCEMENT FEATURES:                                 Op-Ref-98
  297.     MISCELLANEOUS:                                                Op-Ref-100
  298.  
  299.  
  300.     MEMORY MAPS - Information on Memory Allocation:               Back cover
  301.  
  302.     
  303.     
  304.     CMFiler Ver 6.0
  305.     ~~~~~~~~~~~~~~~
  306.     
  307.     INDEX TO TOPICS AND OPERATIONS:
  308.     ______________________________
  309.     
  310.     Topic or Operation            Module   Command            Page 
  311.     
  312.     Appending files: 
  313.      to target panel               Main    Alt-T, then C      1-42 
  314.      to source panel               Main    Alt-T, then B      1-42
  315.     
  316.     Alias path; define             Main    Alt-A              1-33
  317.     
  318.     Alias path; jump to            Main    Alt-1 - Alt-9      1-33
  319.     
  320.     Application launching:  See 
  321.      Child process execution
  322.     
  323.     ASCII entry with keypad:       Edit    Alt-Keypad         2-59
  324.     
  325.     ASCII table                    Edit    Ctrl-A             2-59
  326.     
  327.     Attributes, directory: 
  328.      toggle "Hide", at curs        Main    2                  1-42
  329.      toggle "Hide", at curs        Tree    2                  3-67
  330.     
  331.     Attributes, file: 
  332.      toggle "Read", at curs        Main    1, no tags         1-42
  333.      toggle "Read", tagged         Main    1, w/ tags          " 
  334.      toggle "Hide", at curs        Main    2, no tags          " 
  335.      toggle "Hide", tagged         Main    2, w/ tags          " 
  336.      toggle "Sys", at curs         Main    3, no tags          " 
  337.      toggle "Sys", tagged          Main    3, w/ tags          " 
  338.      toggle "Arcv", at curs        Main    4, no tags          " 
  339.      toggle "Arcv", tagged         Main    4, w/ tags          " 
  340.      zero all attrs, at curs       Main    0, no tags          " 
  341.      zero all attrs, tagged        Main    0, w/ tags          "
  342.     
  343.                                Ind-7
  344.     Back up files in directory:                               1-34 
  345.      file at cursor                Main    B, no tags 
  346.      tagged files in direc         Main    B, w/ tags
  347.     
  348.     Block operations:              Edit                       2-60
  349.     
  350.     Case options:                  Main    Ctl-E              1-30
  351.     
  352.     Change directories: 
  353.      to directory at cursor        Main    Enter              1-32 
  354.      to parent directory           Main    P                   "        
  355.      show direc in opp panel       Main    Shf-Enter           " 
  356.      show parent in opp panel      Main    Shf-P               " 
  357.      to root directory             Main    \                   " 
  358.                                    Tree    Home               3-67
  359.     
  360.     Change to new drive or disk:   Main    N                  1-31 
  361.                                    Tree    N                  3-67
  362.     
  363.     Child process execution: 
  364.      Shell to DOS                  Main    S                  4-78 
  365.      quick execute file at         Main    Q                  4-79 
  366.       cursor, no command tail 
  367.      ready file at cursor          Main    X                  4-79
  368.       for execution 
  369.      seed command tail with        Main    Alt-C              4-80 
  370.       full path spec to file 
  371.       at cursor 
  372.      seed command tail with        Main    Alt-T              4-80 
  373.       name of file at cursor 
  374.      edit command tail and         Main    Alt-X               " 
  375.       execute readied file 
  376.      execute readied file,         Main    Shf-X               "    
  377.       no edit of command tail 
  378.      execute readied file,         Main    Ctl-X               " 
  379.       first adding name of 
  380.       file at cursor to 
  381.       command tail 
  382.      assign executable files       Main    Shf-F10            4-82
  383.       to Function Keys
  384.                                Ind-8
  385.     Color palette:                 Main    Ctl-P              1-29
  386.     
  387.     Command line parameters:                                  4-78
  388.     
  389.     Compare mode, toggle:          M/T     Ctl-C              1-47, 3-67
  390.     
  391.     Concatenating files: 
  392.      to target panel               Main    Alt-T, then C      1-42 
  393.      to source panel               Main    Alt-T, then B       "
  394.     
  395.     Configuration file:                                       1-49
  396.     
  397.     Copy disKette:                 Main    Shf-K              1-53
  398.     
  399.     Copy operations:
  400.      file at cursor to target      Main    C, no tags         1-33 
  401.      tagged files to target        Main    C w/ tags           " 
  402.      freshen one directory         Main    Shf-F              1-40
  403.      from another 
  404.      structure, incl files         Tree    C 3-67
  405.      structure w/o files           Tree    Alt-C              3-70 
  406.      text in marked block          Edit    Alt-C              2-60
  407.     
  408.     Copy with rename:              Main    Alt-R              1-39
  409.     
  410.     Create new file:               Main    F                  2-63
  411.     
  412.     Cursor movement: 
  413.      in directory listings         Main                       1-31 
  414.      in tree structures            Tree                       3-67 
  415.      in editor                     Edit                       2-58
  416.     
  417.     Data entry window:             All                        1-40
  418.     
  419.     Date/time, change file:        Main    Alt-F              1-42
  420.     
  421.     Date/time, display system:     Main    5                  1-48
  422.     
  423.                                Ind-9
  424.     Definitions: 
  425.      ~TRASH~ directory                                        1-35 
  426.      Child process                                            4-77 
  427.      Compare mode                                             1-47
  428.      Hide mode                                                 " 
  429.      Kernel                                                   1-25 
  430.      Module                                                   Ov-20,1-25 
  431.      Overlay                                                  1-25 
  432.      Source panel                                             1-28 
  433.      Target panel                                             1-29
  434.     
  435.     Delete operations: 
  436.      "soft" vs "hard"                                         1-36 
  437.      resetting D to hard                                      1-49 
  438.      file at curs, soft            Main    D, no tags         1-36 
  439.      file at curs, hard            Main    Ctl-D, no tags      " 
  440.      tagged files, soft            Main    D, w/ tags          " 
  441.      tagged files, hard            Main    Ctl-D, w/ tags      " 
  442.      directory at cursor           Main    D, dir void        1-32 
  443.      structure at curs, soft       Tree    D                  3-71 
  444.      structure at curs, hard       Tree    Ctl-D               " 
  445.      text in marked block          Edit    Alt-Y              2-60 
  446.      line of text                  Edit    Ctl-Y              2-58 
  447.      word of text                  Edit    Ctl-T               " 
  448.      text to end of line           Edit    Ctl-D               "
  449.     
  450.     Directory: 
  451.      delete (only if empty)        Main    D                  1-32 
  452.      delete direc structure        Tree    D or Ctl-D         3-71 
  453.      make new                      Main    M                  1-31 
  454.                                    Tree    M                   
  455.      rename                        Main    R                  1-35, 1-37 
  456.                                    Tree    R                  3-67 
  457.      display subdir in srce        Main    Enter              1-32 
  458.      display subdir in trgt        Main    Shf-Enter           " 
  459.      display parent in srce        Main    P                   " 
  460.      display parent in trgt        Main    Shf-P               " 
  461.      display root in source        Main    \                   " 
  462.      display root in target        Main    Shf-\               " 
  463.      display source in trgt        Main    Shf-*               "
  464.     
  465.                                Ind-10
  466.     Diskette copying               Main    Shf-K              1-53
  467.      formatting                    Main    Shf-M              1-52
  468.     
  469.     Display options:  
  470.      show Hidden files,            Main    Ctl-H              1-47 
  471.       dirs; toggle                 Tree    Ctl-H              3-67 
  472.      Compare mode, toggle          Main    Ctl-C              1-47 
  473.                                    Tree    Ctl-C              3-67 
  474.      define filename Mask          Main    Ctl-M              1-48 
  475.      Find text                     Tree    Shf-F              3-74
  476.      Goto (find) directory         Tree    Alt-G              3-73 
  477.      Goto (find) file              Tree    G                  3-72 
  478.      Show file list                Tree    S                   " 
  479.      attrs, size in K              Main    -                  1-42 
  480.      no attrs, full size           Main    +                   "
  481.     
  482.     DOS, Shell to:                 Main    S                  4-78
  483.     
  484.     Edit file at cursor:           Main    E                  2-58
  485.     
  486.     Edit file from notes screen    Main    Alt-E              1-44
  487.     
  488.     Edit file from tree file       Tree    E                  3-74
  489.      list:
  490.     
  491.     File Masking:                  Main    Ctl-M              1-48
  492.     
  493.     File sorting:                  Main    Ctl-O              1-40
  494.     
  495.     Fill floppies from source      Main    Shf-i              1-39 
  496.     
  497.     Find file:                                                3-72
  498.       from main module             Main    Shf-T, then G 
  499.       from tree module             Tree    G
  500.     
  501.     Find string:                   Edit    Alt-F              2-57
  502.     
  503.     Find text:                     Tree    Shf-F              3-74
  504.     
  505.                                Ind-11
  506.     Form feed printer:             Main    Ctl-F/2            1-43 
  507.                                    Tree    Ctl-F/2 
  508.                                    Edit    Ctl-F/2
  509.     
  510.     Format diskette                Main    Shf-M              1-52
  511.     
  512.     Freshen directory from         Main    Shf-F              1-40 
  513.      opposite panel:
  514.     
  515.     Function Keys: 
  516.      assign applications to        Main    Shf-F10            4-82 
  517.       Function keys 
  518.      ready app at F1-F9            Main    Fn                 4-83 
  519.       for execution 
  520.      execute readied Fn app        Main    Alt-X,             4-83 
  521.         Shf-X, or 
  522.         Ctl-X 
  523.      execute app to operate        Main    Ctl-Fn             4-83 
  524.       on file at cursor 
  525.      execute app to operate        Main    Shf-Fn             4-83 
  526.       on constructed command line
  527.     
  528.     Global replace string:         Edit    Alt-G              2-61
  529.     
  530.     Goto file:                     Main    G, then name       1-31 
  531.                                    Tree    G, then name       3-72 
  532.     
  533.     Goto subdirectory:             Main    Alt-G, name        1-31 
  534.      (See also Jump)               Tree    Alt-G, name        3-73
  535.     
  536.     Help, on-line:                 Main    H                  1-51
  537.                                    Tree    H,F1               3-75 
  538.                                    Edit    Alt-H , F1         2-63
  539.     
  540.     Hide mode, toggle:             M/T     Ctl-H              1-47, 3-67
  541.     
  542.     Integrity data:
  543.       Change file name             Main    Alt-I              Ov-22
  544.     
  545.     Jump to path:                  Main    J                  1-32
  546.     
  547.                                Ind-12
  548.     Kernel, resident, set size:    Main    K                  4-77
  549.     
  550.     Launching applications: See 
  551.       Child process execution
  552.     
  553.     Limitations: 
  554.       dir size (300,600,1200)      Main                       Ov-22 
  555.       file size in edit mode       Edit                       Ov-23 
  556.       memory required (240 kb)                                  " 
  557.       tree entries (1700 dirs)     Tree                         " 
  558.       dir nesting (8 levels)       M/T                          "
  559.     
  560.     Make new directory:            Main    M                  1-31 
  561.                                    Tree    M                  
  562.     
  563.     Masking, in direc listing:     Main    Ctl-M              1-48
  564.     
  565.     Monitor options:                                          Ov-22
  566.     
  567.     Moving operations: 
  568.      files                         Main    Shf-C              1-35 
  569.      structures                    Tree    Shf-C              3-70 
  570.      block of marked text          Edit    Alt-V              2-60
  571.     
  572.     New drive or disk, change:     Main    N                  1-31 
  573.                                    Tree    N                  3-67
  574.     
  575.     Notes: edit                    Main    Ctl-N              1-44 
  576.       view                         Main    Shf-N               "
  577.     
  578.     NULL character, entering       Edit    Alt-N              2-59
  579.     
  580.     Options, user, saving          Main    Shf-S              1-48
  581.     
  582.     Options, user, setting         Main    Shf-O              1-49
  583.     
  584.     Ordering scheme, select:       Main    Ctl-O              1-40
  585.     
  586.     Password, entering:            Main    Shf-F10            Ov-21, 4-87
  587.     
  588.                                Ind-13
  589.     Printing: 
  590.      put file in print queue       Main    L                  1-43
  591.       look at print queue          Main    Shf-L               " 
  592.      cancel print queue            Main    Ctl-L               " 
  593.      print directory listing       Main    Alt-L               " 
  594.      print directory listing       Main    Shf-N or Ctl-N,     " 
  595.       with notes                               then Alt-L
  596.       print tree structure         Tree    Alt-L              3-75 
  597.      Print marked text block       Edit    Alt-P              2-61 
  598.      Output block to file          Edit    Alt-O               "
  599.     
  600.     Quitting: 
  601.      to DOS from main module       Main    Esc-other, or      1-54 
  602.                                            Alt-Q 
  603.      to DOS from tree module       Tree    Alt-Q              3-75 
  604.      to main from tree module      Tree    Esc or Enter        "
  605.      to main from file edit        Edit    Esc                2-62 
  606.      to main from file view        Edit    Esc or Enter        "
  607.     
  608.     Relist panel from disk         Main    Shift-R            1-31
  609.                                    Tree    Shift-R
  610.     
  611.     Remove (Delete) directory:     Main    D (must be void)   1-32
  612.     
  613.     Rename file or directory at    Main    R                  1-25, 1-37 
  614.       cursor:                      Tree    R                  3-67
  615.     
  616.     Replace string:                Edit    Alt-R              2-61
  617.     
  618.     Resident kernel, set size:     Main    K   4-77                
  619.     
  620.     Screen saver: 
  621.      normal timeout to             Main                       Ov-21
  622.      forcing before timeout        Main    Ctl-S              Ov-21
  623.       freshening directories       Main                       Ov-24, 1-48 
  624.       after return, switch 
  625.       setting
  626.     
  627.     Security features: 
  628.      cleared slack space                                      Ov-22 
  629.      password access denial        Main                       Ov-21, 4-87
  630.     
  631.                                Ind-14
  632.     Self-checking:                 Main                       Ov-21
  633.     
  634.     Setup options:                 Main    Shf-O              1-49
  635.     
  636.     Shell to DOS:                  Main    S                  4-78
  637.     
  638.     Sorting of (Ordering) files:   Main    Ctl-O              1-40
  639.     
  640.     Splitting files:               Main    Alt-S              1-36
  641.     
  642.     Startup options:                                          1-52
  643.     
  644.     Subdirectories: 
  645.      make new                      Main    M                  1-31 
  646.                                    Tree    M                   
  647.      rename                        Main    R                  1-25, 1-37
  648.                                    Tree    R                  3-67
  649.     
  650.     Tagging operations on files: 
  651.      toggle Tag at cursor          Main    T or Space         1-33 
  652.      toggle All tags in direc      Main    Ctl-A              1-39
  653.      clear or set All tags         Main    A                  1-33 
  654.      all files same naMe as        Main    Alt-M              1-39 
  655.      all files same Ext as         Main    Alt-E               " 
  656.      all files Newer               Main    Alt-N               " 
  657.      all files Older               Main    Alt-O               " 
  658.      all files same Date           Main    Alt-D               " 
  659.      tag in oPposite panel         Main    Alt-P               " 
  660.      "Append" or "Alt" Tag         Main    Alt-T              1-42
  661.     
  662.     Time/date, change file:        Main    Alt-F              1-42
  663.     
  664.     Time/date, display system:     Main    5 or %             1-48
  665.     
  666.     Tree image options:            Tree    Ctl-O
  667.     
  668.     TSR's, precaution about:                                  Ov-22
  669.     
  670.     UNZIPping with PKZIP utils:
  671.      with command line edit        Main    U                  4-85
  672.      no command line edit          Main    Shf-U               "
  673.     
  674.                                Ind-15
  675.     View file at cursor:           Main    Enter              2-55
  676.     
  677.     View file from tree file list: Tree    V                  3-74
  678.     
  679.     Volume label, setting:         Main    V                  1-48
  680.     
  681.     ZIPping with PKZIP utils:
  682.      with command line edit        Main    Z                  4-84
  683.      no command line edit          Main    Shf-Z               "
  684.      designating files to ZIP      Main    T/Alt-T             " 
  685.     
  686.     
  687.     
  688.     
  689.     
  690.     
  691.     
  692.     
  693.     
  694.     
  695.     
  696.     
  697.     
  698.     
  699.     
  700.     
  701.     
  702.     
  703.     
  704.     
  705.     
  706.     
  707.     
  708.     
  709.     
  710.     
  711.     
  712.     
  713.                                Ind-15
  714.     
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.     OVERVIEW:
  722.     ____________________
  723.  
  724.     File Contents . . .
  725.  
  726.       The following files are contained in a complete copy of the
  727.     registered edition of CMFiler Version 6.0:
  728.  
  729.  
  730.       o  CMFILER.COM - The main program file. Run by typing CMFILER at the
  731.          DOS prompt.
  732.  
  733.       o  CMFILER.OVY - The overlay for the main program.  CMFILER.COM loads
  734.          the overlay, which becomes part of the executable code. The user
  735.          should put CMFILER.OVY in the same directory as CMFILER.COM.
  736.  
  737.       o  BRIEF.TXT - A two-page quick guide to CMFiler's command structure.
  738.  
  739.       o  SUPLMENT.TXT - Any additions and corrections to this manual
  740.          reflecting the differences between the current version and 6.02.
  741.  
  742.       o  CHANGES.TXT - A verbose history of all significant changes since
  743.          Version 5.32.
  744.  
  745.       o  SETUP.EXE - Windows installation program
  746.  
  747.       o  SETUP.INI - Initialization file for SETUP.EXE
  748.  
  749.       o  DOSINST.BAT - Installation batch program.
  750.  
  751.       o  CONV_NAR.COM - A small utility to convert old CMFiler-style
  752.          NARATIVE.CF files into NDOS/4DOS DESCRIPTION files.
  753.  
  754.       o  CONV_NAR.TXT - Documentation for CONV_NAR.COM.
  755.  
  756.  
  757.                                     Ov-17 
  758.       o  CMFILER.PIF - Windows program information file provided as a
  759.          reference. It may not be suitable in your system.
  760.  
  761.       o  CMFILER.ICO - Windows icon definition file provided by a CMFiler
  762.          user.
  763.  
  764.       o  READ_ME.TXT - Installation/uninstallation instruction.
  765.  
  766.       o  TESTIMON.IAL - Unsolicited user and media testimonies.
  767.  
  768.  
  769.       The registered edition of CMFiler may not be further distributed.
  770.     The shareware edition is offered  for evaluation and distribution
  771.     unaltered to others, with the understanding that, if used past the 60-
  772.     day trial period, the user will pay a registration fee of $30.  I am
  773.     so convinced of CMFiler's wide usability and appeal that I will send
  774.     any registered user an instant $10 commission each and every time
  775.     someone else registers a copy and cites her or him as the source of
  776.     it!  Registered users may make as much money on commissions by passing
  777.     the evaluation (shareware) edition of CMFiler to others as they care
  778.     to.  CMFiler must be passed as an unaltered collection of the
  779.     shareware file set.
  780.  
  781.       CMFiler provides a quick, simple, "one-touch" operating environment
  782.     for your IBM-compatible 80x86-based computer running under DOS Version
  783.     3 or later.  While its name implies it is a file manager, it is much,
  784.     much more. Once you have used CMFiler for a few sessions, you will not
  785.     want to struggle with the DOS COMMAND.COM command processor or your
  786.     other file managers ever again!  CMFiler was painstakingly written in
  787.     Assembly language over an eight-year period, carefully factoring in
  788.     the suggestions of dozens of the world's pickiest software critics.
  789.     It is compact and lightning fast.
  790.  
  791.       CMFiler is capable of doing everything your DOS COMMAND.COM
  792.     processor or other file manager can do, and more, but with ease! -
  793.     displaying two directories side-by-side; copying one or more files
  794.     from one directory to another; backing up files in the same directory;
  795.     deleting or renaming files and directories; setting file and directory
  796.     attributes; concatenating (stringing together) multiple files; viewing
  797.     and editing files; making and removing subdirectories; printing files
  798.     in the "background" while you perform other tasks; setting disk volume
  799.     labels; printing directory listings; keeping notes; displaying two
  800.  
  801.                                     Ov-18 
  802.     disk structures side-by-side as "trees", and performing a full set of
  803.     operations on their structures; and launching other programs - all
  804.     with a minimum number of keystrokes and maximum "transparency".
  805.  
  806.       Operations are keyed to single-letter mnemonics, making CMFiler
  807.     intuitive and easy to learn.  For example, the letter C means "copy",
  808.     the letter D "delete", and so forth.  Almost everything you need to
  809.     know about CMFiler is contained in a two-line prompt at the bottom of
  810.     the screen, or can be summoned instantly with a single keystroke
  811.     (surprise! H for "help"), with no delay for external file reading,
  812.     since the help is imbedded in the program code.  There are only a few
  813.     things for which you will need to refer to this manual once you begin
  814.     using CMFiler.
  815.  
  816.       CMFiler employs the BIOS and DOS disk service routines which are
  817.     embedded in ROM or loaded into RAM when your computer boots, and the
  818.     DOS file operation safeguards and error flags are employed, such as
  819.     denying access to remove non-void subdirectories.  I have added a few
  820.     of my own, such as protection of files against being overwritten by
  821.     zero-length files of the same name (resulting from an occasional DOS
  822.     read-write failure).
  823.  
  824.       CMFiler performs most operations immediately, and does not ask for
  825.     confirmation as other file managers do, unless file destruction is
  826.     involved.  You must confirm with a separate keystroke, for example,
  827.     that you really do want to delete files, or that you really do want to
  828.     overwrite a more recent version of a file during a copy operation.
  829.     Otherwise CMFiler takes for granted that you are doing exactly what
  830.     you had in mind, on the basis that a mistake can be recovered from
  831.     with just a few more keystrokes.  The "mass" operations, like copying
  832.     or deleting large numbers of tagged files, all have an Esc bailout.
  833.  
  834.  
  835.     Program Logical and Physical Organization. . .
  836.  
  837.       The CMFiler program code is organized "logically" (in the
  838.     programmer's sense) into three sections, or "modules". These will be
  839.     referred to variously as the "main module" or "main screen";  the
  840.     "editor module" or "editor"; and the "tree module" or "tree
  841.     functions".  Each module performs some major function or group of
  842.     functions which is fundamentally different from the rest, discussed
  843.     further below.  On the other hand, the program is broken physically
  844.  
  845.                                     Ov-19 
  846.     into two main pieces, in this case two files, namely, the file
  847.     "CMFILER.COM", sometimes referred to herein as the "kernel"; and the
  848.     file "CMFILER.OVY", or the "overlay". The kernel contains the most
  849.     vital part of the main module, the "starter", and the overlay, which
  850.     the kernel loads contiguous to itself in memory, contains the rest of
  851.     the main module, plus the editor and tree modules.  A memory map is
  852.     included at the end of this manual for those interested.
  853.  
  854.       The main module displays one directory on the left side of the
  855.     screen, or two directories in side-by-side panels.  The names of the
  856.     subdirectories of each directory are always shown at the top of the
  857.     listing in alphabetical order, following by the names of the files in
  858.     one of nine user-specified ordering schemes.  Commands operate on a
  859.     subdirectory or one or more files in one panel (the source panel).
  860.     Some commands, like Copy, write to the directory in the other panel
  861.     (the target panel).  The main module gives a somewhat myopic or
  862.     "microscopic" view of your disk, one directory at a time, but does so
  863.     with the most complete set of file and directory services available in
  864.     any file manager today.  The other two modules (editor and tree) are
  865.     accessed from the main, and the editor may also be accessed from the
  866.     tree.
  867.  
  868.       The editor is called to create, edit or view a file.  To edit or
  869.     view an existing file in the main module, just put the cursor on it
  870.     and press E or Enter.  To create a file, press F and type in a name
  871.     for the new file.
  872.  
  873.       The tree module is called from the main module with Shift-T. It
  874.     displays the entire directory tree structure of one disk in the left
  875.     panel, or two trees for the same or different disks in side-by-side
  876.     panels. Whole structures ("branches") of a tree, or if you wish just
  877.     the files in one directory, may be copied, moved or deleted in their
  878.     entirety. Some file manager documentation call this kind of capability
  879.     "prune-and-graft". This capability is "macroscopic" in scope, compared
  880.     to the main module, as it deals with the big picture of your disk
  881.     organization. But CMFiler does much more in this mode than most file
  882.     managers. In addition to the "macroscopic" prune-and-graft-type
  883.     operators, you may do some microscopic things as well, like display
  884.     the files in each subdirectory as you navigate through the tree, find
  885.     a specific file anywhere on the disk, search for a text string in all
  886.     or some of the files on the disk - even view or edit a file, and
  887.     delete it without having to return to the main file services module.
  888.  
  889.                                     Ov-20 
  890.     This latter feature in particular makes disk cleanup a breeze!
  891.  
  892.  
  893.     Security Features. . .
  894.  
  895.       CMFiler incorporates security features which support its use on
  896.     systems containing sensitive information:
  897.  
  898.       o  You may specify a password, and change it at any time during a
  899.     session, which must be given back to reenter CMFiler once it has gone
  900.     to screen-saver mode (about 1-1/2 minutes after last keystroke from
  901.     main screen display). This password is the bottom-most field in the
  902.     data entry screen presented by the key combination Shift-F10 -
  903.     discussed in further detail in Chapter 4.
  904.  
  905.       o  You may force CMFiler into screen-saver mode with the key
  906.     combination Ctrl-S. This is so that, if you want to secure access to
  907.     your computer immediately, you don't have to wait the 1-1/2 minutes
  908.     for the screen-saver and password to automatically be invoked.
  909.  
  910.       o  During any file copy operation, CMFiler always fills in the
  911.     "slack space" in the last sector with the string "cfcfcf  . . . ", to
  912.     ensure that no sensitive information residual in the DOS I/O buffers
  913.     is inadvertently passed into the last sector slack space.
  914.  
  915.       o  If you set the option "wipe old files before HARD  Delete, " on
  916.     the Shift-O user Options screen, CMFiler overwrites all the data
  917.     sectors of old files with "cfcfcf . . . " before calling the DOS file-
  918.     delete service (which does not destroy data, but alters only the
  919.     directory table). This feature ensures complete data destruction and
  920.     is useful if you deal with sensitive information.
  921.  
  922.       o  CMFiler employs a rudimentary check-summing routine to check the
  923.     .COM and .OVY files each time they are loaded.  This routine will
  924.     sense any changes in the execution code and fixed data areas of either
  925.     file, and warn the user of the corruption. Files may become corrupted
  926.     as a result of an operating system error during data transmission, a
  927.     sector going bad on a disk, or external tampering by a person or a
  928.     virus. This check-summing feature can detect (and has detected) the
  929.     presence of some older file infecting viruses, but may be foiled by
  930.     modern stealth viruses, so do not count on it for virus protection.
  931.     There is no substitute for good antivirus software. I use and strongly
  932.  
  933.                                     Ov-21 
  934.     recommend Wolfgang Stiller's Integrity Master. He is President of
  935.     Stiller Research and a member of the ASP's Virus Information Panel,
  936.     and a recognized expert in the anti-virus community.
  937.  
  938.       o  CMFiler also protects the file integrity signature data created
  939.     by your anti-virus software from being overcopied. The default
  940.     integrity data file name is ZZ##.IM, the default assigned by Stiller's
  941.     Integrity Master, but this name may be changed with Alt-I (for "ID
  942.     name change").
  943.  
  944.       o  CMFiler's floppy diskette formatter positively overwrites all
  945.     data on the diskette, ensuring the destruction of any sensitive or
  946.     classified information.
  947.  
  948.  
  949.     Monitor Options. . .
  950.  
  951.       CMFiler should work with all reasonably current IBM-compatible
  952.     CGA/EGA/VGA and monochrome monitors, though I have heard of some
  953.     problems with machines under very early BIOS (Basic Input/Output
  954.     System) versions.
  955.  
  956.       When first run, if CMFiler cannot find a .CFG file containing
  957.     previously specified user option data, and does not sense a monochrome
  958.     video card installed (which only supports one color set), it knows it
  959.     cannot tell for sure what you have installed and will ask you to
  960.     specify a monitor type by pressing C, V, L, T, E or M. Your choice is
  961.     recorded by CMFiler creating a .CFG file. If you have an LCD monitor
  962.     other than Tandy or Epson, you may invoke a generic LCD color set with
  963.     the letter L. For Tandy or Epson LCD's try T or E. If you are not
  964.     satisfied with the result, try the choices available in the Shift-O
  965.     user Option screen, lines 10 and 11, until one seems to work.
  966.  
  967.       If you have a "monochrome" monitor being driven by a color card,
  968.     CMFiler senses the color card's presence, not the monitor's. Press M
  969.     for this case to force the monochrome color set.
  970.  
  971.       When running CMFILER.COM from the DOS prompt, you may put one of
  972.     these six letters in the command line, preceded by the character @,
  973.     and bypass the initial question.
  974.  
  975.  
  976.  
  977.                                     Ov-22 
  978.     Precautions and Limitations. . .
  979.  
  980.       There are a few precautions and limitations the user should be aware
  981.     of:
  982.  
  983.       o  Terminate-and-Stay-Resident programs should not be launched
  984.     from CMFiler. At best you will end up with a fragmented
  985.     memory when you exit CMFiler, and at worst you will have a
  986.     system crash.
  987.  
  988.       o  CMFiler requires a minimum of 252 kb of free memory to run.  This
  989.     permits generous memory allocations for the directory listings, a
  990.     print spooler buffer, and a copy buffer. During application launching,
  991.     however, the resident portion of CMFiler can be made to occupy as
  992.     little as 22 kb, using the "Small" footprint option of the "Kernel"
  993.     command (letter K pressed from the main screen - discussed more in
  994.     Chapters 1 and 4). This is the default selection on initial start-up.
  995.  
  996.       o  Maximum directory size recognized by the main module varies from
  997.     300 to 2400 entries, depending on free memory available. If the
  998.     directory size limit is reached, an informational note is given. The
  999.     rest of the directory is inaccessible, as though it were hidden. This
  1000.     is a benign, non-damaging limitation.
  1001.  
  1002.       o  The algorithms used by the editor module place certain
  1003.     limitations on it in "edit" mode which do not apply in "view" mode. If
  1004.     you attempt to edit a file which exceeds these limitations, the editor
  1005.     reverts to view mode automatically:
  1006.  
  1007.          -  Files too large to fit in available memory in one shot, or
  1008.          -  Files with more than 16,380 lines.
  1009.          -  Files with lines longer than 8190 characters if editing in
  1010.             "NoWrap" mode.
  1011.  
  1012.       o  The tree module limits the number of entries in a directory tree
  1013.     structure to 1700 total subdirectories. The limit on number of files
  1014.     is strictly a function of available memory.
  1015.  
  1016.       o  The main and tree modules both limit the depth of directory
  1017.     nesting to eight levels (e.g., "C:\1\2\3\4\5\6\7\8" is an example of
  1018.     the most deeply nested path allowed), and the length of path
  1019.     specifications to 66 characters (this is a DOS limitation).
  1020.  
  1021.                                     Ov-23 
  1022.       o  A limitation of DOS itself which users frequently run into and
  1023.     are puzzled by, because of the cryptic error message DOS returns, is
  1024.     the maximum number of entries permitted in the root directory. This
  1025.     number is 112 for 5.25" disks formatted at 360kb and 3.5" @ 720kb; and
  1026.     224 for 5.25" @ 1.2Mb and 3.5" @ 1.44Mb. The error message returned is
  1027.     "Access denied creating file". Be aware that the volume label and each
  1028.     subdirectory is an "entry", as well as each file.
  1029.  
  1030.  
  1031.     Assumption about User's Familiarity with DOS. . .
  1032.  
  1033.       It is assumed that the user knows at least a smattering about DOS
  1034.     system operation, and has at least a beginner's understanding of the
  1035.     use of the DOS COMMAND.COM processor, or other file management
  1036.     programs.  I assume terms like "file", "subdirectory" and "path" need
  1037.     not be defined. If these are alien notions, however, there are many
  1038.     books on DOS within easy reach of any user.
  1039.  
  1040.  
  1041.     Additional Note for Windows Users. . .
  1042.  
  1043.       Though not designated as a Windows application, CMFiler is operating
  1044.     satisfactorily as a DOS program in the Windows environment (3.1, 3.11,
  1045.     and Win 95). One nuisance feature will probably need to be corrected
  1046.     if you are running it under Windows, however. The default assumption
  1047.     on return from screen saver mode is that the disk directories have not
  1048.     been altered while CMFiler has been idling. Under Windows, this is not
  1049.     necessarily a valid assumption, since another foreground application
  1050.     may have operated on the directories CMFiler was selected to when it
  1051.     went into the background. Therefore for Windows there is a switch
  1052.     which may be set in the Shift-O user Option screen telling CMFiler to
  1053.     refresh the directory listing on return from the screen saver.
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.                                     Ov-24 
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.     TUTORIAL - Chapter 1: File Handling:
  1073.     ____________________
  1074.  
  1075.     Getting Started , or the "Kernel" and the "Overlay":
  1076.  
  1077.       As mentioned in the OVERVIEW above, I refer to the 22 kb CMFILER.COM
  1078.     file as the "kernel", the vital part of the main module, and the 134
  1079.     kb CMFILER.OVY file as the "overlay", which contains the rest of the
  1080.     main module and the editor and tree modules. Physically breaking the
  1081.     program into two files served two purposes - it got around an arcane
  1082.     64 KB limit on .COM files imposed by DOS, and it let me give you two
  1083.     options for how much of the program to leave resident in memory when
  1084.     launching applications from CMFiler (more in Chapter 4).
  1085.  
  1086.       For now, copy CMFILER.COM and CMFILER.OVY into the root directory of
  1087.     your hard disk or a working floppy using your good ol' DOS COMMAND.COM
  1088.     processor, and save a write-protected copy for your library.  With the
  1089.     DOS system prompt showing the drive these two files are now on, run
  1090.     the kernel CMFILER.COM by entering "cmfiler" or "CMFILER". The DOS
  1091.     command processor will load and execute CMFILER.COM, which in turn
  1092.     will find and load the overlay CMFILER.OVY.  The whole 156 kb (22 +
  1093.     134) is now residing in memory, ready to respond to commands.
  1094.  
  1095.       The first thing you will likely see is a request for monitor
  1096.     information.  CMFiler cannot distinguish between a color monitor and
  1097.     an LCD monitor, and the default color set for the color monitor is a
  1098.     poor choice for most LCD monitors. When you see the message, press C,
  1099.     V, M, L, E or T for the monitor you think most closely describes
  1100.     yours. (It can be changed later).  CMFiler will create a file of user
  1101.     configuration data (called CMFILER.CFG) in the same directory the .COM
  1102.     file is in. It will update this file as you select other setup
  1103.     options.
  1104.  
  1105.  
  1106.     Rename CMFILER to Spare My Fingers . . .
  1107.  
  1108.       Now, feel free to rename CMFILER.COM to "CF.COM" for short, and the
  1109.     overlay and configuration files from CMFILER.OVY and CMFILER.CFG to
  1110.     "CF.OVY" and "CF.CFG".  (It is important to keep all these files named
  1111.  
  1112.                                      1-25 
  1113.     the same, by the way.)  In fact I will refer to them simply as "CF"
  1114.     from here on, since that results in fewer keystrokes for me!  Put the
  1115.     cursor on the line reading "CMFILER  COM" and press the letter R (for
  1116.     "rename"). A window will open up at the bottom that says:
  1117.  
  1118.        Rename      CMFILER.COM
  1119.          to       >CMFILER.COM<
  1120.  
  1121.     with the cursor blinking on the first position in the data entry field
  1122.     denoted by the ">  <" pair.  (CMFiler is assuming that you want to
  1123.     rename just the  CMFILER.COM file, since the most frequent use of the
  1124.     rename facility is renaming single files; and is offering you the same
  1125.     name as the "default" entry in the new name field, since often when
  1126.     you rename a file, you may be only changing a few characters.)
  1127.  
  1128.       In this case we want to rename all the files that start with
  1129.     "CMFILER";  that is, we would really like to use the DOS "wild card"
  1130.     convention "*".  If we were renaming this family of files from the DOS
  1131.     prompt, we would type in the command "ren cmfiler.* cf.*".  In the
  1132.     CMFiler rename facility, the upper line is the first parameter of the
  1133.     DOS rename command, the lower line the second.  We therefore want the
  1134.     upper line to read "CMFILER.*".  To do this, press either the up arrow
  1135.     or PgUp, and press Tab to move over to the "C" in "COM". Type "*". and
  1136.     press Enter or down arrow.  Now the window reads:
  1137.  
  1138.        Rename     CMFILER.*
  1139.          to      >CMFILER.*<
  1140.  
  1141.       Simply type "CF.*" and press Enter.  The files are now renamed.
  1142.  
  1143.       This quick exercise sounded complicated when you read it, but won't
  1144.     be when you try it.  And it illustrates a few "nice touches" I have
  1145.     tried to build in to minimize your keystrokes.
  1146.  
  1147.       From here on the explanations are not so detailed.  I recommend you
  1148.     fiddle with scratch directories initially, until you are familiar with
  1149.     all of CF's capabilities.  If you are running DOS Version 2, put CF,
  1150.     both the .COM and .OVY files, on one of the paths defined in a DOS
  1151.     "path" command, so that it can "find" itself after running other
  1152.     applications.  Under DOS Version 3 and later, it is only necessary
  1153.     that both be in the same directory, which need not be in the DOS path
  1154.     environment.
  1155.  
  1156.  
  1157.  
  1158.  
  1159.                                      1-26 
  1160.     The Screen . .  .
  1161.  
  1162.       You should by now have noted an economy of screen usage.  The left
  1163.     panel shows the contents of the current directory on the default
  1164.     drive. Line 1 of this active panel shows the disk volume name if any,
  1165.     and a prompt area for four display enhancement features: the key
  1166.     combination Ctrl-O (denoted by ^O to save space) allows selection of
  1167.     one of nine file Ordering schemes; ^H toggles the "Hide" mode switch;
  1168.     ^C toggles the "Compare" mode switch; and ^M allows specifying a file
  1169.     "Mask". Line 2 shows the path to the current directory. In 25 line
  1170.     video display mode, the first 20 entries, directories first, then
  1171.     files, are displayed in lines 3-22.  Line 23 gives vital information
  1172.     about the disk, such as room left, and lines 24-25 contain an
  1173.     abbreviated help screen.
  1174.  
  1175.       The thick versus thin sections of the vertical line to the left of
  1176.     the file list denote the relative position and size of the current
  1177.     screen display within the full directory listing.
  1178.  
  1179.       If you do not press a key within about 1-1/2 minutes, the screen
  1180.     goes into screen-saver mode.  Just press any key to return to the main
  1181.     display.  You may force the screen-Saver mode with Ctrl-S.
  1182.  
  1183.  
  1184.     The Help Area . . .
  1185.  
  1186.       The two-line help area at the bottom of the screen contains a set of
  1187.     abbreviated cues to assist with the recollection of the mnemonic
  1188.     single-key commands.  With no "modifier" keys pressed [i.e., the
  1189.     Shift-, Alt-and Ctrl- keys all up], the help area shows the operations
  1190.     available with the unmodified keys, with the mnemonic code
  1191.     highlighted. These are typically the most frequently used operations;
  1192.     the letter C for "Copy file(s), E for "Edit file", D for "Delete file
  1193.     or directory", T for "Tag file", the number 1 for "toggle the file
  1194.     Read-only attribute", and so forth.
  1195.  
  1196.       Additional commands are available which use similar mnemonic
  1197.     devices, but with the keyboard modified by Shift-, Alt- or Ctrl-.
  1198.     Press one of the Shift- keys, and notice the change in the bottom
  1199.     lines. These are the commands enabled by the letters shown in
  1200.     highlight, modified by the key you are holding down.  Press Ctrl- and
  1201.     Alt- in turn. All these operations, both "unmodified" and "modified",
  1202.     will be explained as we go along. Just be aware that the visual cues
  1203.     for the modifier keys are there when you want them.
  1204.  
  1205.  
  1206.                                      1-27 
  1207.     More on the "Modifier Keys" . . .
  1208.  
  1209.       Incidentally, there is some rationale for which of the Shift-, Alt-
  1210.     or Ctrl- keys was used as the modifier for a particular "modified"
  1211.     operation, and there are some devices which may help you remember the
  1212.     modified keys as well as the more straightforward mnemonic devices of
  1213.     the unmodified keys:
  1214.  
  1215.       o    The modifier "Shift-" is often used for operations involving
  1216.     transfers of control or data to or from the other panel.  For example,
  1217.     Shift-Enter, when the cursor is on a subdirectory entry, means display
  1218.     this subdirectory in the other panel and jump across to it. Other
  1219.     commands which follow this convention, and which you will encounter in
  1220.     more detail, are Shift-Left/Rt Arrow, Shift-P, Shift-*, Shift-\, and
  1221.     Shift-F.
  1222.  
  1223.       o    The modifier "Ctrl-" is most often used to "toggle" the state
  1224.     of a "switch" or "tags" - that is, to invert something.  For example,
  1225.     Ctrl-H toggles the state of the "hide switch" , i.e., if Y ("yes" or
  1226.     "on") it goes to N ("no" or "off"), if N it goes to Y.  Other examples
  1227.     include Ctrl-O, Ctrl-M, Ctrl-C, Ctrl-A, and Ctrl-L.
  1228.  
  1229.       o    The modifier "Alt-" is most often used just to indicate an
  1230.     operation associated with a mnemonic alphabet key, but for which the
  1231.     unmodified key was already in use as a mnemonic for a more frequent
  1232.     operation.  For example, C means "Copy", and is one of the most
  1233.     frequent operations; Alt-C means "add file spec to Command tail", and
  1234.     is used far less frequently.  (In the editor, Alt-modified keys are
  1235.     used a lot, since the unmodified keys are used for typing text!)
  1236.  
  1237.  
  1238.     Two Panels . . .
  1239.  
  1240.       Each  "panel" corresponds to a "path" to files, in the DOS
  1241.     vernacular, and the terms "panel" and "path" are used interchangeably
  1242.     throughout. Open the right panel by pressing the right arrow.  You
  1243.     will be prompted at the bottom of the screen to specify a drive
  1244.     letter. (The bottom lines become the "dialog" area for information to
  1245.     you about what CF is doing, or what it is waiting for you to do.)
  1246.     Just press the letter corresponding to a valid drive - don't press
  1247.     Enter, just a letter key. The current directory of that drive will be
  1248.     shown in the right panel in the same format as the left panel. The
  1249.     bright yellow color of the path specification on line 2 and the
  1250.     blinking cursor now identify the right panel as the "source" path.
  1251.     The left panel has become the "target" or "destination" path for the
  1252.  
  1253.                                      1-28 
  1254.     copy , append and move operations. Ctrl-W sWaps the panels left and
  1255.     right.
  1256.  
  1257.       Whenever CF is in "Compare" mode and the cursor is on the name of a
  1258.     file in the source panel that also happens to exist anywhere in the
  1259.     target path, the target panel display is adjusted so that the file
  1260.     appears in the panel, and its date/time signature is put in high-
  1261.     intensity to catch your eye and show you the duplication. If the date,
  1262.     time and size of the two files are not the same, the date/time
  1263.     signature of the newer file will blink. You can toggle compare mode
  1264.     off and on with the key combination Ctrl-C (for "Compare").
  1265.  
  1266.  
  1267.     Color Palette . . .
  1268.  
  1269.       For display in CGA/EGA/VGA systems, CF has four choices of color
  1270.     palettes.  The command Ctrl-P (for Palette) lets you cycle through the
  1271.     choices with the spacebar, and select a different color scheme with
  1272.     Enter or return to the original one with Esc.  The choice may be
  1273.     permanently recorded in the .CFG file (discussed in more detail
  1274.     later).
  1275.  
  1276.       In addition, each palette can now be edited by pressing E within the
  1277.     palette facility.  Each of five colors in the file list display can be
  1278.     selected by arrowing around an 8x8 color array, and pressing the
  1279.     spacebar when the desired color is reached.  The affect of each
  1280.     selection is shown as the arrow is moved around the color array, so no
  1281.     guesswork is required.
  1282.  
  1283.       This facility is best used with both panels open, and some files
  1284.     tagged in one of the panels, since the file tagging color and both the
  1285.     source and target path line colors are independently variable.  When
  1286.     finished editing one palette, hit Enter to return to the original
  1287.     level of the palette facility, and either Enter to set that palette as
  1288.     the default choice, or another key to rotate to the next palette.  The
  1289.     editor and tree displays are not independently adjustable, but take
  1290.     their colors from the current palette.
  1291.  
  1292.       The palette edit routine (Ctrl-P, E) also has the option to
  1293.     toggle the  high-intensity bit selectively for each color field.  The
  1294.     command "T" in the color menu toggles between high- and normal-
  1295.     intensity foreground color attribute.
  1296.  
  1297.       In addition, the color palette exit sequence has the option to
  1298.     set an internal flag which causes a "pip" to be shown in front of the
  1299.  
  1300.                                      1-29 
  1301.     extension of each file with today's date stamp, and colors the
  1302.     extensions of certain "preferred" files differently from the normal
  1303.     file color.  The initial setting of this flag is "on", and the
  1304.     "preferred" extensions which are specified for the special colors are
  1305.     the executables - .COM, .EXE, .BAT and .BTM.  The flag may be turned
  1306.     off, and the preferred extension colors may be edited:
  1307.  
  1308.          1.  When you leave the palette menu with the Enter key, you will
  1309.     be asked if you want to flag today's files and the "preferred" files. If
  1310.     you answer No, the exit sequence is complete.
  1311.  
  1312.          2.  If you answer Yes, you will be given an opportunity to edit
  1313.     the colors for each of the preferred extensions in the same way as you
  1314.     edited the main palette colors.  When you are finished, exit this
  1315.     secondary color facility with the Enter key.
  1316.  
  1317.       The preferred extensions may themselves be edited in the Ctrl-O
  1318.     Order menu.
  1319.  
  1320.  
  1321.     Alphabetic Case Options . . .
  1322.  
  1323.       CF also has four options for the alphabetic cases used in the panel
  1324.     displays.  The command Ctrl-E (for casE) lets you cycle through the
  1325.     choices with the spacebar, as in the Palette above, which are:  1)
  1326.     files and directories all upper case, 2) directories in upper case,
  1327.     files in lower, 3) all in lower case, and 4) all in "modified-Tauck"
  1328.     convention, where all letters are lower case except the first and any
  1329.     that follows a non-alphabetic character (e.g., Cmfiler.Com or Read-
  1330.     Me.1St).  Case 2 is the default, but I find case 4 easiest to read.
  1331.  
  1332.  
  1333.     Cursor Movement . . .
  1334.  
  1335.       Shift back and forth with the left and right arrow keys.  You are in
  1336.     effect switching source and target paths.  Use the up/down arrows,
  1337.     PgUp/PgDn, Home and End keys to move the cursor within a panel. PgUp
  1338.     moves the cursor to the top of the panel if it was not already there,
  1339.     and then moves up one page in the directory. PgDn is similar for the
  1340.     opposite direction.  Home goes to the first line of the directory, End
  1341.     to the last.
  1342.  
  1343.       If a mouse driver is installed, CF will respond to mouse movement by
  1344.     opening a five-symbol menu bar beside the highlighted entry. Click the
  1345.     left button on the triangular up or down arrow symbol for PgUp or
  1346.  
  1347.                                      1-30 
  1348.     PgDn. Click on the triangular left or right arrow symbol to jump
  1349.     across to the opposite panel.
  1350.  
  1351.       The command G (for "Go to...") lets you type in a file name to move
  1352.     the cursor to within the directory listing. As you type, the cursor is
  1353.     repositioned to the first file described by the character string you
  1354.     are building. When you have come to the file you want, press Enter or
  1355.     Esc. Alt-G is the equivalent "Go to. . ." for subdirectories.
  1356.  
  1357.       In Compare mode, whenever there is a duplicate file name highlighted
  1358.     in the opposite panel, you may jump directly across to it with the
  1359.     move Shift-Left/Right Arrow, vice the unmodified arrows.
  1360.  
  1361.       The default cursor configuration is a block shape, to make it easy
  1362.     to find on the screen. You may reduce the size of the cursor by
  1363.     pressing Ctrl-K (for "Kursor" height - shown as "Kursht" in the prompt
  1364.     area). Each press decreases the height. This configuration can be
  1365.     saved to the CF.CFG file.
  1366.  
  1367.  
  1368.     Switching Drives or Disks . . .
  1369.  
  1370.       CF cannot tell when you have changed disks in the drive whose
  1371.     contents are shown on one of the screen panels.  You have to tell it
  1372.     by putting the cursor in that panel and pressing Shift-R (for
  1373.     "Relist"), or N (for "New disk"), and then the letter designator for
  1374.     that drive at the ensuing prompt. If you want to switch drives, say
  1375.     from A to B for the right-hand panel, put the cursor to the right,
  1376.     press N and B.
  1377.  
  1378.       Alternatively, click the left button on the three-line menu symbol
  1379.     in the mouse bar, click on the "New drive" line, and highlight and
  1380.     click on the letter of the desired drive.
  1381.  
  1382.       Sometimes when you are doing single-panel operations, like
  1383.     constructing a note set or editing files, it is a distraction to have
  1384.     both screen panels open at once.  To close the right-hand panel and
  1385.     return to single left-hand panel display, put the cursor in the right-
  1386.     hand panel and press N and Enter.
  1387.  
  1388.  
  1389.     Subdirectories . . .
  1390.  
  1391.       Make a new subdirectory in the source path by pressing Ins while the
  1392.     cursor is on a directory, or M (for the DOS command "Mkdir") and
  1393.  
  1394.                                      1-31 
  1395.     entering a name.  CF will create this directory and put the cursor on
  1396.     it. Press Enter. Note the new path on line 2 of the screen display,
  1397.     and only the "<Parent>" entry in the file listing.  Go back to the
  1398.     parent directory by pressing Enter with the cursor on the "<Parent>"
  1399.     entry, or P (for "Parent") with the cursor anywhere in the panel.  You
  1400.     can navigate down and back up through the directory levels in a path
  1401.     this way, one level at a time.  If you are several levels deep, there
  1402.     is another quicker way back to the root directory than by hitting P
  1403.     repeatedly, and that is by pressing the backslash key \.  It works
  1404.     like the DOS command "cd \".
  1405.  
  1406.       To change directories using the mouse, highlight the directory name
  1407.     by moving the mouse up or down, move the mouse left to highlight the
  1408.     left-arrow symbol, and click the left button. (Clicking on this
  1409.     leftmost mouse bar arrow symbol always has the same effect as hitting
  1410.     the Enter key.)
  1411.  
  1412.       To put a subdirectory from the current source panel list into the
  1413.     target panel, put the cursor on its name and press Shift-Enter. The
  1414.     subdirectory is listed in the opposite panel, and the cursor shifts
  1415.     over to it.  In similar fashion, Shift-P puts the source panel's
  1416.     parent directory into the opposite panel, and Shift-\ puts the
  1417.     source's root into the opposite panel.  Finally, Shift-* puts the
  1418.     source directory itself into the target.  This is handy for quickly
  1419.     setting up the same directories side-by-side for ZIPping/UNZIPping,
  1420.     discussed in Chapter 4.
  1421.  
  1422.       Remove a subdirectory by placing the cursor on it and pressing Del
  1423.     or D (for "Delete", which I use interchangeably for file deletion and
  1424.     subdirectory removal).  Note that the subdirectory has to be empty
  1425.     first - a DOS safeguard that I have preserved.
  1426.  
  1427.  
  1428.     Swapping Panels . . .
  1429.  
  1430.       In the main and tree modules, you can quickly swap panels left-for-
  1431.     right and right-for-left, keeping the cursor in the same panel, left
  1432.     or right, with the command Ctrl-W (for sWap).
  1433.  
  1434.  
  1435.     Jump Command . . .
  1436.  
  1437.       The Jump command may be used to jump to another path. In either
  1438.     panel, press J, and type in the new path, including drive if desired.
  1439.     If the path exists, CMFiler will read and display its directory
  1440.  
  1441.                                      1-32 
  1442.     contents and set it as the new path for that panel.
  1443.  
  1444.  
  1445.     Path Alias Facility . . .
  1446.  
  1447.       A "path alias" facility is available in the main module. This
  1448.     allows assigning the commands Alt-1 through Alt-9 to your nine most
  1449.     frequently used directories, for instant navigation from any drive and
  1450.     path.  To assign a path to the alias list, first go to the
  1451.     subdirectory you want to add, then press Alt-A (for Alias).  The Alias
  1452.     menu shows a list numbered 1 through 9, each with a user-definable
  1453.     title and path.  Pick a free number, press it and type in the title
  1454.     you want as your key for the path.  Hitting Enter saves the alias.
  1455.  
  1456.       To navigate to that aliased path instantly, either press Alt- and
  1457.     the number you assigned (if you remember), or press Alt-A, look over
  1458.     the list, and while still holding down the Alt-key press the number.
  1459.     The alias facility can also be used in place of pressing a drive
  1460.     letter after the New drive command, or when arrowing over to the
  1461.     right-hand panel when it is blank.  The Shift- key, used with Alt-1
  1462.     through Alt-9, puts the aliased path into the opposite panel and goes
  1463.     across to it, in much the same way as Shift-\, Shift-P and Shift-Enter
  1464.     on a directory name act to put the selected directory into the
  1465.     opposite path and jump across.
  1466.  
  1467.  
  1468.     Copy Some Files, then Do It with Tags . . .
  1469.  
  1470.       Put the cursor on a file name and press the letter C.  This copies
  1471.     the file from the source to the target path.  "Tag" several files with
  1472.     the letter T or the Spacebar or with the mouse right button.  Now
  1473.     press C to copy this group from source to target.  Clear all the tags
  1474.     with A (tag/untag All).  Press A again, and see that all the files are
  1475.     now tagged.  Untag an individual file with T. ("T" actually toggles
  1476.     the state of an internal tag bit assigned to each file and used for
  1477.     temporary marking purposes only. "A" clears all the tags if any were
  1478.     set, or sets all the tags if all were clear. No information is changed
  1479.     on the disk itself.  These are "volatile" tags, maintained only until
  1480.     the directory is re-read for some reason, such as a file deletion or a
  1481.     copy operation into the directory.)
  1482.  
  1483.       Copying files is also a selection in the mouse menu, popped up by
  1484.     clicking on the three-line symbol in the mouse bar.
  1485.  
  1486.       CF looks first at the space available on the target path before it
  1487.  
  1488.                                      1-33 
  1489.     starts to copy.   If it doesn't see enough room free, it doesn't start
  1490.     the operation, and alerts you to this limitation.  This prevents write
  1491.     errors, messed up file allocation tables and incomplete files that can
  1492.     result when space runs out during a copy operation.
  1493.  
  1494.       CF has several special features in the copy operation:
  1495.  
  1496.       o  If an identical file exists in the target path - same name,
  1497.     extension, date, time and size - CF does not normally copy the source
  1498.     to the target, as this would be wasted motion, on the assumption that
  1499.     the files are identical.  This "no overcopy" feature is controlled by
  1500.     one of the switches which may be toggled in the user options menu
  1501.     brought up with the command Shift-O.  It is sometimes useful to change
  1502.     its state.
  1503.  
  1504.       o  If a file by the same name but newer date/time is found on the
  1505.     target, CF will ask you specifically to verify that you really do want
  1506.     the newer file overwritten.
  1507.  
  1508.       o  If the source and target files have the same date/time but the
  1509.     source is a different size, CF will ask for overwrite confirmation.
  1510.     If the source file has length 0 bytes, it will never overwrite a non-
  1511.     zero-length target. Zero-length target files will always be
  1512.     overwritten by non-zero-length source files of the same name,
  1513.     regardless of age. These features provide some protection against
  1514.     overwriting  good files with ones which have become corrupted by
  1515.     previous copy errors.
  1516.  
  1517.       o  If a file by the same name but with the read-only attribute set
  1518.     is found on the target, CF will ask you to verify that you want it
  1519.     overwritten.  (Likewise if the target file is hidden and the hide
  1520.     switch is on.)
  1521.  
  1522.  
  1523.     Tagging, Backing Up . . .
  1524.  
  1525.       With a couple of files tagged, look at the line just below the last
  1526.     line of the directory listing. You will see the space in use in the
  1527.     current directory ("KB Used"), the amount of disk space occupied by
  1528.     any tagged files ("Tagd") and the space still free ("Free"). Also, in
  1529.     the line below will appear after each tagging operation the current
  1530.     number of files tagged. Disk space is expressed in kilobytes, rounded
  1531.     up to the nearest integer value.
  1532.  
  1533.       Assuming the amount of space represented by tagged files is less
  1534.  
  1535.                                      1-34 
  1536.     than or equal to space available, press B to back up all the tagged
  1537.     files. CF's convention for assigning backup file names in this
  1538.     operation is to reuse the name and the first two letters of the
  1539.     extension (filling blanks with exclamation points if necessary), and
  1540.     then make the last letter of the extension a tilde character (~).Thus
  1541.     the backup should always immediately follow the primary file in any
  1542.     alphabetical listing.
  1543.  
  1544.  
  1545.     Moving Files . . .
  1546.  
  1547.       With the panels selected to different subdirectories on the same
  1548.     disk, one or more files may be "moved" from one subdirectory to the
  1549.     other. This operation does not read and write the file data clusters,
  1550.     but only changes the subdirectory table entries, so large files may be
  1551.     moved around quickly. Tag files if desired, as with Copy, and press
  1552.     the move command Shift-C (instead of C - think of moving as just
  1553.     another kind of "copying", but you are "shifting" files to a different
  1554.     directory instead).
  1555.  
  1556.       If the conditions are not satisfied for moving the files (e.g. the
  1557.     directories are not on the same disk), CF will copy the files to the
  1558.     target path, and then ask for confirmation that you want to hard-
  1559.     delete the source files to complete the move operation. This
  1560.     encumbrance is deliberate; because CMFiler is so fast, I have made it
  1561.     require confirmation whenever any file destruction is involved.
  1562.  
  1563.  
  1564.     Deleting a File . . .
  1565.  
  1566.       With the cursor on a file and no files tagged, pressing Del or D
  1567.     results in deleting the file at the cursor, after confirmation. If one
  1568.     or more files are tagged, they will be deleted after confirmation, not
  1569.     the file at the cursor. Alt-Tags, discussed below, are  treated the
  1570.     same as normal tags as far as the delete operation is concerned.
  1571.  
  1572.       On hard disks, the default configuration of CF actually performs
  1573.     what I will call a "soft" delete for this operation. The files are not
  1574.     deleted using the DOS delete function, but rather are moved into a
  1575.     "trash can" directory created by CF, called "~TRASH~". If you delete
  1576.     files from your hard disk by mistake, they are reliably recoverable
  1577.     just by switching to the ~TRASH~  directory and moving them back to
  1578.     the directories they came from using Shift-C.
  1579.  
  1580.       If you delete a second file by the same name as a file already
  1581.  
  1582.                                      1-35 
  1583.     collected in the ~TRASH~ directory by a previous soft delete
  1584.     operation, CF tries to rename this second file by replacing the last
  1585.     character in the extension with a "1". If this name is already in use,
  1586.     it tries to rename with a "2" instead, then a "3", and so on, through
  1587.     "9". Thus, you are assured under all reasonable circumstances of not
  1588.     losing any deleted files, even duplicates.
  1589.  
  1590.       Each time you select a new drive in the main module, CF looks to see
  1591.     if it is a hard drive (A and B are always taken to be floppies), and
  1592.     then looks in ~TRASH~ if it exists for the presence of files. If it
  1593.     finds any, it will ask you if you want to purge them - that is,
  1594.     perform the "hard" DOS file delete on the current trash. You have the
  1595.     options "yes", "no", or "Enter to view" to see what is in the trash
  1596.     can. You probably want to keep the ~TRASH~ as uncluttered as possible,
  1597.     just to avoid tying up disk space needlessly. If you prefer to "empty
  1598.     the trash" less often than daily, be prepared to be pestered with the
  1599.     same question the first time you select that disk each day!  (The D
  1600.     command always performs a "hard" delete in the ~TRASH~ directory -this
  1601.     is the one exception.)
  1602.  
  1603.       This "soft" delete facility is not intended as a means of backing up
  1604.     files, but rather is built in solely for the purpose of reliable
  1605.     recovery from inadvertent file deletion.
  1606.  
  1607.       An additional delete option is available - Ctrl-D, or "hard" delete.
  1608.     This operation performs the DOS delete always, regardless of the type
  1609.     disk selected.  Use it when you know you will not want to recover the
  1610.     deleted files. If you wish to obliterate all data in files before
  1611.     issuing the hard delete command, set the flag "Wipe old files . . . "
  1612.     in the Shift-O user Options screen.
  1613.  
  1614.       And if you are really sure of yourself, you can turn D from soft
  1615.     delete to hard delete.  There is a switch available for this purpose
  1616.     also in the Shift-O user Options menu mentioned above.
  1617.  
  1618.  
  1619.     File Splitter . . .
  1620.  
  1621.       The main module has a file splitter, called by Alt-S. With the
  1622.     target panel set up as the destination path for the split files,
  1623.     position the cursor on a file in the source panel and press Alt-S.
  1624.     CMFiler first asks for confirmation that you desire to split the file
  1625.     into smaller files, with extensions .A00, .A01, - , .A99, .B00, etc.
  1626.     Then it asks for the file size for the split files, in kilobytes.
  1627.     Split files are created in the target path, and the original file is
  1628.  
  1629.                                      1-36 
  1630.     left untouched in the source.  The file splitter provides the option
  1631.     to split files at the nearest end-of-line (defined by a carriage
  1632.     return, a line feed, or the combination in either order), which is
  1633.     useful in splitting text files.  The file splitter also works with a
  1634.     single panel open.
  1635.  
  1636.  
  1637.     The Tagging Convention Expounded on . . .
  1638.  
  1639.       For all the above commands (copy, delete, move, back up), the
  1640.     operation is performed on all the tagged files in the source panel, if
  1641.     any are tagged, and only on the file at the cursor if none are tagged.
  1642.     Some file managers offer different commands for "copy tagged" and
  1643.     "copy file at cursor", and so forth. I have always found this
  1644.     unnecessarily complicated. For the few occasions in which you have a
  1645.     bunch of files tagged to do one of these operations (say you want to
  1646.     copy them), and you discover just before you start that you really
  1647.     wanted to do some other operation on just one of them first (say you
  1648.     realize one of them is out-of-date and you want to delete it), you
  1649.     will have to either untag them all with A, do the operation on the one
  1650.     file, then retag and do the original operation; or just postpone the
  1651.     one-file operation. For this example, it is easier just to toggle the
  1652.     tag on the one out-of-date file off with T, copy the other bunch,
  1653.     clear the tags, and delete the one. It becomes just a matter of a
  1654.     little thought about the order in which you do things.
  1655.  
  1656.       The "view" operation (discussed in Chapter 2) does not clear
  1657.     existing tags.  So, suppose you are cleaning up a disk, tagging files
  1658.     that you recognize by name as no longer needed in preparation for a
  1659.     single, massive delete, and you come to one you aren't sure about. Put
  1660.     the cursor on it, press Enter (the "view" command), browse through it
  1661.     and decide if it's a keeper, and Esc from view mode. Note the
  1662.     previously placed tags are still there, and the cursor is still on the
  1663.     mystery file waiting for you to decide whether or not to tag it.
  1664.  
  1665.  
  1666.     Renaming a File or a Directory . . .
  1667.  
  1668.       Since we've already done this, I'll just briefly say that it works
  1669.     for directories, too. A word about the wild card character "*". In the
  1670.     earlier exercise, we used it in the first window to declare that we
  1671.     wanted to rename all the files with "CMFILER" as the name, and any
  1672.     extension, to "CF" with the same extension. You may use the "*" in the
  1673.     name field of the first window instead of the extension, but not in
  1674.     both. Used in the name field, it means "change this extension,
  1675.  
  1676.                                      1-37 
  1677.     wherever it appears, to this other extension". This option is less
  1678.     useful.
  1679.  
  1680.       If used in the first data window, the "*" must also be used in the
  1681.     second window in the same position.  CF always senses the use of "*"
  1682.     in the first window, and seeds the second window with this character
  1683.     in the right position.
  1684.  
  1685.       The "*" may be used in the second window, even if not in the first,
  1686.     as a shorthand for "keep the same name (extension)". For example, if
  1687.     you wanted to rename just "PACKING.LST" to "PKG.LST", put the cursor
  1688.     on "PACKING.LST" in the source panel, press R, type "PKG.*" in the
  1689.     lower window, and Enter.  Saves some keystrokes. This is a wild card
  1690.     convention taken from DOS.  (Sorry to you DOS heavies - for simplicity
  1691.     I chose not to complicate things by including "?" in the wild card
  1692.     library for this facility!)
  1693.  
  1694.       There is a special file name-swapping feature that lets you quickly
  1695.     swap system files like AUTOEXEC and CONFIG for special-purpose
  1696.     backups. If you tag exactly two files and press R, the rename facility
  1697.     asks if you want to swap the names of the two tagged files. If you
  1698.     decline, the normal rename facility is activated for the file at the
  1699.     cursor.
  1700.  
  1701.       The rename facility supports Windows 95 long filenames.  If CF
  1702.     detects Win95 as the operating system, it will add a note to the
  1703.     rename prompt area telling you to press the Down Arrow key for long
  1704.     filename support.  Pressing Down Arrow opens a box next to the
  1705.     filename for long filename entry.
  1706.  
  1707.       Win95 long filenames may be up to 255 characters. Win95 assigns an
  1708.     "alias" filename in regular DOS 8.3 convention consisting of the first
  1709.     six non-white-space characters of the long filename plus a tilde (~)
  1710.     and a number, followed by the extension assigned to the long filename.
  1711.     In using Win95 long filenames, it is advisable to pick the first word
  1712.     in a way that the alias 8.3 filename will mean something to you.  For
  1713.     example, if you name all your correspondence files "Letter to Jim 2-3-
  1714.     96", "Letter to Sally 4-5-95", and so forth, the file listing in CF
  1715.     (which uses the 8.3 aliases) will look like this "LETTER~1",
  1716.     "LETTER~2", and so forth.
  1717.  
  1718.       You can see the full long filenames using the notes facility in CF,
  1719.     discussed later.
  1720.  
  1721.  
  1722.  
  1723.                                      1-38 
  1724.     Some Additional Tagging Options . . .
  1725.  
  1726.       In addition to T or spacebar (which toggles the state of an
  1727.     individual file's "normal" Tag) and A (which clears or sets All tags),
  1728.     there are some more tagging operations.  Alt-T applies an "append
  1729.     tag", discussed later. Alt-M tags all the files in the panel with the
  1730.     same naMe as the file under the cursor, Alt-E same Extension.  Alt-D
  1731.     tags all files in the panel with the same Date as the file at the
  1732.     cursor, Alt-N tags all files Newer, and Alt-O Older.  Alt-P tags in
  1733.     the oPposite panel all the files with the same names as files tagged
  1734.     in the source panel.  And finally, Ctrl-A toggles the state of All
  1735.     tags in the panel.
  1736.  
  1737.       If, for example, you wanted to copy all .COM files, put the cursor
  1738.     on any .COM file, press Alt-E, and C.  Or suppose that, at the end of
  1739.     the day, you wanted to copy/update all the files written or revised
  1740.     today. Just put the cursor on any file with today's date and press
  1741.     Alt-D and C. Then suppose you wanted to delete all the earlier files.
  1742.     Press A to clear the tags, Alt-O and D, and confirm the deletion as
  1743.     requested, after a final check of the screen.
  1744.  
  1745.  
  1746.     Copy with Rename . . .
  1747.  
  1748.       You may copy a file and rename it in one operation.  Only one file
  1749.     at a time may be copied in this way.  The command is Alt-R (copy with
  1750.     Rename).  It operates only on the file at the cursor. Pressing Down
  1751.     Arrow enables Win 95 long filename support for the file to be renamed.
  1752.  
  1753.  
  1754.     The Floppy "Filler" . . .
  1755.  
  1756.       CF can fill a collection of floppy disks from a hard disk directory.
  1757.     This is good for making wholesale backups. Select in one panel the
  1758.     directory from which you want to fill  (the source). Tag all the files
  1759.     you want to copy (CF will tag them all if none were tagged), and press
  1760.     Shift-i (for "f i ll"). CF will first ask which floppy drive to fill
  1761.     to, and how much space you want to reserve on each floppy for future
  1762.     growth. Then it will copy as many files as it can to that drive, and
  1763.     prompt you to insert the next disk. If the disk is not already
  1764.     formatted, CF will ask what density you want, and then format the disk
  1765.     before continuing with filling. CF will repeat this process until the
  1766.     whole directory is copied.
  1767.  
  1768.       This floppy filler is "smart". It first looks at each floppy to see
  1769.  
  1770.                                      1-39 
  1771.     if there are existing files that need to be updated, and copies them
  1772.     first. Then it copies other files to fill the remaining space if it
  1773.     can. Thus the floppy filler can be used to update a set of existing
  1774.     backups as well as create a new set.
  1775.  
  1776.       After each floppy disk is filled, the source files that were
  1777.     successfully copied are untagged. You may interrupt the fill operation
  1778.     and then resume it where you left off, as long as you leave the source
  1779.     panel with its tagged files as-is.
  1780.  
  1781.  
  1782.     The File Freshener . . .
  1783.  
  1784.       CF can also freshen the files in one directory from another. The
  1785.     convention is to freshen the source from the target, so it works
  1786.     opposite the floppy filler. With the source panel set up on the
  1787.     directory to be freshened, and the files tagged that you want
  1788.     freshened (CF will tag them all if none are tagged), CF will update
  1789.     the directory by copying from the target all the newer files whose
  1790.     names match tagged files in the source.
  1791.  
  1792.  
  1793.     Different Ways to Show the Files . . .
  1794.  
  1795.       Ctrl-O (for "Order") sets a screen which gives nine choices for file
  1796.     ordering, with the current selection highlighted.  Press a number key
  1797.     1 through 9.  The files will now be reordered in the new scheme.  You
  1798.     may toggle the sort algorithm between "bubblesort" and "quicksort"
  1799.     with the letter A.
  1800.  
  1801.       Pressing E in this screen allows editing three "preferred
  1802.     extensions." These are file extensions which will be highlighted by
  1803.     special colors, which may be selected in the Ctrl-P Palette menu.
  1804.     Files with preferred extensions may be listed first by toggling the
  1805.     switch in this screen with P.
  1806.  
  1807.  
  1808.     The Data Entry Window . . .
  1809.  
  1810.       The data entry window defined by the "> <" pair you encounter for
  1811.     input data  responds to most of the usual line-editing key presses:
  1812.  
  1813.       o  The Insert key toggles between Typeover and Insert mode.  The
  1814.     mode indicated as an "i" or "t" in front of the ">",stays set for each
  1815.     subsequent entry.  In Typeover mode, any default entry is cleared if
  1816.  
  1817.                                      1-40 
  1818.     the first keystroke is an alphanumeric character.
  1819.  
  1820.       o  Ctrl-Lf/Rt Arrow and Tab/Shift-Tab go right or left to the space
  1821.     following the next blank or punctuation mark.
  1822.  
  1823.       o  Home goes to the beginning of the field. End goes to the first
  1824.     blank following the last non-blank character.
  1825.  
  1826.       o  Lf/Rt Arr, Bksp and Del perform the usual functions.
  1827.  
  1828.       o  Alt-Keypad permits entry of any ASCII code as a decimal number.
  1829.     Hold down the Alt-key while you type in a number from 1 to 255 on the
  1830.     numeric keypad.  When you lift the Alt-key, the IBM symbol for that
  1831.     ASCII code will appear in the window, and the cursor will advance a
  1832.     space.
  1833.  
  1834.       o  Ctrl-D deletes to the end of the line.
  1835.  
  1836.       o  Esc cancels the operation.
  1837.  
  1838.       o  Down Arrow is equivalent to Enter.  In some cases, Up Arrow
  1839.     moves up a line.  (The rename facility in the main module and the
  1840.     "replace string" facility in the editor use this keystroke to move up
  1841.     to the entry above.)
  1842.  
  1843.       For entering file names and subdirectories, all letter keys are
  1844.     registered as upper case, regardless of Caps Lock or Shift-key
  1845.     positions, just for the sake of uniformity and ease of alphabetizing.
  1846.     For command lines parameters, which may be case-sensitive, both cases
  1847.     are enabled.
  1848.  
  1849.  
  1850.     Integer Kilobytes versus Actual File Size . . .
  1851.  
  1852.       Now take a look at the file listing.  You see the name of the file,
  1853.     date, time and size in kb.  As with the disk space information just
  1854.     below the file list display, size is in integer multiples of
  1855.     kilobytes. If you want to see exactly how big a file is, in bytes,
  1856.     press "+" to expand the size field. (I had to give away the file
  1857.     attributes to do this and still keep the two panels readable.)  Shift
  1858.     back to the "contracted" kilobyte form of file size with "-".
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.                                      1-41 
  1865.     File Attributes . . .
  1866.  
  1867.       Also in the file list, to the far right in each panel, you will
  1868.     probably see A's.  This means that the DOS "Archive" attribute bit is
  1869.     set in the file attribute byte.  DOS sets this bit every time it
  1870.     operates on a file.  CF lets you operate on this bit and the other
  1871.     bits in the DOS file attribute byte - "Read-only", "Hidden", and
  1872.     "System".  Before doing this exercise, look at the top line of the
  1873.     display.  If you see "^Hide=N", that means that files with the DOS
  1874.     "Hidden" attribute set will be displayed anyway - i. e., the CF "Hide
  1875.     switch" is off.  Chances are you will see "N" instead of "Y", meaning
  1876.     that the Hide switch is off - the default setting.  In the "Y"
  1877.     setting, files will disappear from view as you set the DOS hidden
  1878.     attribute, so you need to ensure the hide switch is set to "N".  Press
  1879.     Ctrl-H if necessary to toggle the hide switch off.
  1880.  
  1881.       Either tag one or more files, or position the cursor on the file
  1882.     whose attribute(s) you want to set, and press 1 to toggle the state of
  1883.     the Read-only attribute, 2 to toggle the Hidden attribute, 3 to toggle
  1884.     the System file attribute, 4 to toggle the Archive attribute, or 0
  1885.     (zero) to clear all attributes.  You may also toggle the hidden
  1886.     attribute (with 2) of a subdirectory, but this may be done one
  1887.     subdirectory at a time. Note that "hiding" a file makes it invisible
  1888.     to CF only when the hide switch is set on, as shown in the top line.
  1889.     Decide for yourself which setting of the hide switch you prefer.  Some
  1890.     people like to hide the "overhead" files and directories on their
  1891.     disks, and leave the hide switch on as the default setting to "clean
  1892.     up" the display.
  1893.  
  1894.  
  1895.     Changing the Date/Time Stamp of a File . . .
  1896.  
  1897.       You may change the date/time of a file by putting the cursor on it
  1898.     and pressing Alt-F.  Data windows open for you to enter the new date
  1899.     and time, with the old date/time as default. You may set a group of
  1900.     files to the same date/time by tagging them first, then pressing Alt-
  1901.     F, and confirming the operation for the group.
  1902.  
  1903.  
  1904.     "Alt-Tagging" and Appending . . .
  1905.  
  1906.       Suppose you have two files that you want to concatenate (stick
  1907.     together as one, heel-to-toe).  Tag them with "append" tags with the
  1908.     key combination Alt-T or Alt-spacebar in the order in which you want
  1909.     them to be concatenated, and press C.  CF will offer you a file name
  1910.  
  1911.                                      1-42 
  1912.     for the new concatenated file consisting of the name of the first file
  1913.     Alt-Tagged plus the extension "APF" (for APpended File). You may edit
  1914.     or accept this name as given.Then CF creates this file in the target
  1915.     path and appends into this  file each of the Alt-Tagged source files
  1916.     in order.  You may concatenate up to 35 files at a time this way.  The
  1917.     order in which the file was Alt-Tagged is shown in the character that
  1918.     appears to the left of the file name as it is tagged (1-9, then a-z).
  1919.     Or, if you had pressed B instead of C after affixing the Alt-Tags, the
  1920.     concatenated file would have been written as a backup into the source
  1921.     path instead of the target.
  1922.  
  1923.  
  1924.     Printing a File . . .
  1925.  
  1926.       You can print a file to the parallel printer just by putting the
  1927.     cursor on the file and pressing L (print fiLe).  A menu will appear as
  1928.     follows:
  1929.  
  1930.  
  1931.     ----------------------------------------------------------------
  1932.  
  1933.          Move cursor with Up/Dn Arrow; type option desired.
  1934.  
  1935.               Form feed after print, if not one already? Y
  1936.               Print header with file name and date/time? N
  1937.                       Set left margin of 0/5/10 spaces   0
  1938.                             Send file to  LPT1 or LPT2?  1
  1939.  
  1940.          Press Esc to cancel file print, Enter to proceed.
  1941.  
  1942.     ----------------------------------------------------------------
  1943.  
  1944.       Modify the defaults as desired, and press Enter to print the file.
  1945.  
  1946.       The file will be put into a special print "queue" for printing to
  1947.     the parallel port of your choice as a background process while you are
  1948.     doing other things, like editing another file, updating disks, etc.
  1949.     Up to five files may be put in the print queue, which may be viewed
  1950.     with Shift-L.
  1951.  
  1952.       At times the printer may halt momentarily during disk operations. CF
  1953.     gives preference to disk operations over printing, to avoid any
  1954.     conflict in time-critical operations. You may terminate printing with
  1955.     Ctrl-L. This actually clears the entire print queue. To force a form
  1956.     feed at the end of the file you have just queued, press Ctrl-F before
  1957.  
  1958.                                      1-43 
  1959.     you queue the next file. CF sets an internal flag to check that the
  1960.     last character sent to the printer from that file is a form feed. If
  1961.     it is not, then it sends one. (Ctrl-F is active when no file is
  1962.     printing, also, as a way of form-feeding the printer from the
  1963.     keyboard.)
  1964.  
  1965.  
  1966.     Making Some Notes About Your Files . . .
  1967.  
  1968.       If you are like me, you sometimes forget what a program with a
  1969.     strange name does, or what a particular data file is. CF lets you
  1970.     write notes to yourself about any file. Press Ctrl-N and a Notepad
  1971.     opens up in the opposite panel for editing. You can type a description
  1972.     for each file or subdirectory in the directory. The editing keys work
  1973.     much the same as in the line editor. Each time you call up the
  1974.     notepad, it appears as it did the last time you edited it. You may
  1975.     just browse with the up/down arrows, PgUp/Dn, Home/End, edit or add,
  1976.     etc. Leave the notepad with Esc or Ctrl-Enter. If you use Esc and did
  1977.     any editing, you will be asked if you want to save that edit of the
  1978.     notes. Exiting with Ctrl-Enter automatically saves the edit.
  1979.  
  1980.       A "view Notes" command Shift-N simply replaces the target panel
  1981.     display with the notes for the source panel, but all the file and
  1982.     directory service commands, including the source-to-target commands,
  1983.     such as Copy and move (Shift-C), are still active. However, the
  1984.     blinking feature in the directory comparison mode is disabled while
  1985.     the opposite panel is showing the notes.
  1986.  
  1987.       The notepad is contained in a file called "DESCRIPT.ION", following
  1988.     the convention of NDOS/4DOS, and notes follow the file when it is
  1989.     copied or moved to another path or renamed.  If you delete a file, its
  1990.     notes will be lost the next time you call up the notepad.  You may
  1991.     make the DESCRIPT.ION file Hidden and/or Read-only with user Options
  1992.     in the Shift-O menu.
  1993.  
  1994.  
  1995.     Notes in Version 6 and Windows 95 Long Filename Support . . .
  1996.  
  1997.       CMFiler now fully recognizes Windows 95 long filenames, and
  1998.     preserves them in all copy and move operations in the main module and
  1999.     tree module. The editor preserves the long filename when editing a
  2000.     file, but not in the original file when saving it as a backup.  The
  2001.     notes facility in CF imports long filenames as notes.  The Make
  2002.     directory and make File commands, as well as the Rename command, allow
  2003.     creation of new directories and files with long filenames.
  2004.  
  2005.                                      1-44 
  2006.       File and directory make and rename functions, F, M and R, go
  2007.     initially to standard DOS 8.3 format.  However, one press of the Down
  2008.     Arrow key selects Win95 long filename mode, if Windows 95 is
  2009.     installed.
  2010.  
  2011.       In Version 6, the old CF note file format, NARATIVE.CF, is retired,
  2012.     and notes are now kept in the standard DESCRIPT.ION file format
  2013.     established by 4DOS and NDOS. Before running CF Version 6 the first
  2014.     time, run the companion utility CONV-NAR.COM in the CF file set.  This
  2015.     utility examines every directory on any hard disk you request, and
  2016.     does the following:
  2017.  
  2018.       a.  Reads and loads as an image in memory the DESCRIPT.ION file for
  2019.     this directory, if one exists.
  2020.  
  2021.       b.  Determines if Win95 is the operating system, and if so, finds
  2022.     all long filenames and imports them into the memory image of the
  2023.     DESCRIPT.ION file.
  2024.  
  2025.       c.  Reads and translates into DESCRIPT.ION format the NARATIVE.CF
  2026.     file for this directory, if one exists, and adds to the memory image.
  2027.  
  2028.       d.  Reads and translates the DIRN-???.DAT file for this directory,
  2029.     if one exists, and adds to the memory image.
  2030.  
  2031.       e.  Removes duplicates, then checks each note to see if it has a
  2032.     corresponding directory entry, removing extraneous notes, and writes a
  2033.     new DESCRIPT.ION file into the directory.
  2034.  
  2035.       f.  If the new DESCRIPT.ION was made without error, deletes the old,
  2036.     now superfluous NARATIVE.CF file.
  2037.  
  2038.       The heirarchy in consolidating existing notes into the new
  2039.     DESCRIPT.ION file is: (1) existing DESCRIPT.ION entry; (2) Win95 long
  2040.     filename; (3) existing NARATIVE.CF entry; and (4) existing DIRN-
  2041.     ???.DAT entry.  The CF view-notes and edit-notes facilities also
  2042.     perform the same consolidation in the specific directory in which they
  2043.     are called, so information will not be lost by not running CONV-
  2044.     NAR.COM first.  However, for efficiency, it is recommended that CONV-
  2045.     NAR be run before CF Version 6.
  2046.  
  2047.        As an assist in quickly loading DESCRIPT.ION files with many (>300)
  2048.     notes, CF also creates a file called DESCRIPT.PTR, which is a table of
  2049.     pointers to the starting address of each note in memory.  This
  2050.     companion file to DESCRIPT.ION is non-essential, and is for time-
  2051.  
  2052.                                      1-45 
  2053.     savings only. It may be deleted if there is some indication it has
  2054.     become corrupt, such as loss of notes in the view-Notes facility.
  2055.  
  2056.       The previous limit of 39 characters on notes viewed or made in CF no
  2057.     longer applies with this changeover in Version 6.  Notes may be up to
  2058.     260 characters long.  Win95 users should be aware that Win95 puts a
  2059.     system limitation of 255 characters for long filenames on files and
  2060.     directories, and 260 characters total for full path specifications
  2061.     using long filenames.
  2062.  
  2063.  
  2064.     About Win95 Long Filename Aliases . . .
  2065.  
  2066.       When a long filename (LFN) is created in Win95, Win95 also assigns
  2067.     an "alias" filename in standard DOS 8.3 format. This alias generally
  2068.     consists of the first six characters of the long filename, not
  2069.     counting whitespace, plus the "~" character and a number, starting
  2070.     with 1, plus the LFN's extension, if it exists.  Thus the alias Win95
  2071.     would try to assign to the long filename "This is a long filename.txt"
  2072.     would be THISIS~1.TXT.  However, if a file by this 8.3 name already
  2073.     exists in the directory ("folder"), then Win95 increases the numerical
  2074.     tail until it finds a unique alias.
  2075.  
  2076.       CF still uses the 8.3 filename as the primary sort and display name
  2077.     for all files, even Win95 LFNs.  It is possible to have the same 8.3
  2078.     LFN aliases representing different files in different directories.
  2079.     They may appear to be the same file in the CF side-by-side listings,
  2080.     but they may or may not be the same.  During copy and move operations,
  2081.     however, CF uses the actual LFNs for establishing the identity of
  2082.     files, and applies the safety nets for overcopying newer files with
  2083.     older of the same LFN, or read-only files with non-read-only files
  2084.     with the same LFN. Likewise, if you copy one file with a given LFN
  2085.     alias from one directory into another which has an entry with the same
  2086.     LFN alias, but a different LFN (i.e., is actually a different file),
  2087.     CF will copy the file using the Win95 extended LFN file services, and
  2088.     let Win95 assign a different alias.  In this way, CF prevents any
  2089.     possibility of inadvertent file destruction resulting from confusion
  2090.     over LFN aliases.
  2091.  
  2092.       However, what this also means is that you may have to use the CF
  2093.     view-notes facility (Shift-N) when comparing directories side-by-side,
  2094.     to see whether same-named LFN aliases represent the same or different
  2095.     files. A good practice in assigning long filenames is to use unique
  2096.     first words or character combinations.  Avoid naming every letter
  2097.     "Letter to Jim", "Letter to Sarah", but rather try "Jim Jones letter
  2098.  
  2099.                                      1-46 
  2100.     1-3-96", "Sarah Smith letter 2-5-95", and so forth.
  2101.  
  2102.  
  2103.     Printing a Directory Listing . . .
  2104.  
  2105.       Press Alt-L to send a directory Listing to line printer 1. If you do
  2106.     this from either of the Notes displays, you also get a listing of the
  2107.     notes, and the file size entries are either the abbreviated or full
  2108.     values, depending on the display mode set in the directory table
  2109.     (toggled with + and -).
  2110.  
  2111.  
  2112.     Comparison Mode . . .
  2113.  
  2114.       At the top of the screen you see a message "^Comp=Y". The "Y" means
  2115.     comparison mode is enabled, so that any file in the target panel whose
  2116.     name is the same as the file in the source panel will be shown and its
  2117.     date-time stamp highlighted for easy identification. If the files have
  2118.     different date-time, the newer version will be blinking, except when
  2119.     viewing notes. You may toggle this switch with the key combination
  2120.     Ctrl-C.
  2121.  
  2122.       In comparison mode there is a useful feature which enables you to
  2123.     get quickly to a file with the same name in the opposite panel. In
  2124.     arrowing back and forth between panels in comparison mode, with some
  2125.     files by the same name in each panel, you probably noticed that the
  2126.     target panel shifted as necessary to bring the duplicate name into
  2127.     view, but as soon as you shifted over to the target panel, it
  2128.     "remembered" and adjusted the display back to where the top line and
  2129.     cursor had been left, and you lost the duplicate file from view. But
  2130.     suppose you had seen a more recent file in the target panel, as
  2131.     evidenced by the blinking highlight, and you really wanted immediately
  2132.     to arrow over to it and copy it into the source.  The Shift-Left/Rt
  2133.     Arrow combination does this. It resets the target panel display
  2134.     parameters so the cursor goes right to the matched file name.
  2135.  
  2136.  
  2137.     Hide Mode . . .
  2138.  
  2139.       Also at the top is the message "^Hide=Y". The "Y" means that hide
  2140.     mode is enabled - the screen display will not show any hidden files -
  2141.     those with the hidden attribute set. This is handy for cleaning up
  2142.     your displays - just hide the overhead! You may toggle the state of
  2143.     this switch with the key combination Ctrl-H.  The current state of the
  2144.     Hide and Compare switches is set as the default any time you do a
  2145.  
  2146.                                      1-47 
  2147.     Shift-O user Options, a Shift-S options Save, or a Shift-F10 edit,
  2148.     discussed in Chapter 4 on application launching.
  2149.  
  2150.  
  2151.     Mask Template . . .
  2152.  
  2153.       Also at the top is the message "^Mask=*.*". This is a mask that lets
  2154.     you sift out all but files with a certain characteristic. For example,
  2155.     if you want to see only the .EXE files, press Ctrl-M, Tab, type "EXE",
  2156.     and Enter. Tab and Shift-Tab position the cursor on the extension and
  2157.     name fields, respectively. The left and right panel masks can be set
  2158.     independently. As a visual reminder, the mask blinks whenever it is
  2159.     other than *.*.
  2160.  
  2161.  
  2162.     Displaying System Date and Time . . .
  2163.  
  2164.       The display of system date and time may be toggled on or off with
  2165.     the "5" key. There is no obvious mnemonic; however, one user suggested
  2166.     that 5 o'clock is Miller "Time".
  2167.  
  2168.  
  2169.     Changing or Adding a Volume Label . . .
  2170.  
  2171.       Press V and a data window opens at the bottom for you to enter a new
  2172.     volume label for your disk. The existing volume label is offered as a
  2173.     default for editing ease.
  2174.  
  2175.  
  2176.     Some Safeguards . . .
  2177.  
  2178.       As noted above, you can't remove a directory unless it is void of
  2179.     files. This is a built-in DOS safeguard that CF passes along to you,
  2180.     since it uses the DOS file handling services. In addition, CF asks you
  2181.     to verify any requested delete operation; any requested copy operation
  2182.     that would overwrite a file of the same name but newer date/time in
  2183.     the target path, a read-only or system file, or a hidden file with the
  2184.     hide switch on.
  2185.  
  2186.  
  2187.     Saving User Setup Options . . .
  2188.  
  2189.       You have already read about three cases in which features can be
  2190.     reset from their default (or "as-delivered") condition using a special
  2191.     user Option menu summoned by Shift-O. The "soft" delete can be
  2192.  
  2193.                                      1-48 
  2194.     redefined as a "hard" delete, the DESCRIPT.ION notes file can be
  2195.     defined as Hidden and/or Read-only, and the identical-file overcopy
  2196.     switch may be set on or off. There are twelve such features, total,
  2197.     available for setting to your specifications. When you visit this menu
  2198.     and then leave by pressing Enter, the configuration file CF.CFG is
  2199.     updated so that these switches settings are remembered the next time
  2200.     you run CF. The nature of these thirteen switches is such that you
  2201.     probably will not change them often. They represent your preferences
  2202.     as to a standard configuration of features.
  2203.  
  2204.       When you press Shift-O, you will see the following menu:
  2205.  
  2206.     -------------------------------------------------------------------
  2207.  
  2208.         Move cursor with Up/Dn Arrow.  Type option desired.
  2209.  
  2210.                                            Define F1 as Help? Y
  2211.                                  Redefine "D" as HARD Delete? N
  2212.                            Wipe old files before HARD Delete? N
  2213.                      Overcopy files with same date/time/size? N
  2214.                Refresh directory contents after Screen Saver? N
  2215.                      Assign Hidden attr to DESCRIPT.ION file? N
  2216.                   Assign Read-only attr to DESCRIPT.ION file? N
  2217.                         Turn off DESCRIPT.ION file updating?  N
  2218.                                        Turn Screen Saver off? N
  2219.                        Use European date convention dd-mm-yy? N
  2220.                  Invert function of high intensity color bit? N
  2221.          Cga/ega, Vga, Mono:    LCD: Tandy, Epson, other Lcd  V
  2222.                                   VGA display: 25/43/50 lines 4
  2223.  
  2224.             Press Esc to cancel changes, Enter to accept.
  2225.  
  2226.     --------------------------------------------------------------------
  2227.  
  2228.       These thirteen  "switches" represent setup features that various
  2229.     users have asked for.  The default settings are as shown for the first
  2230.     ten.  Any switch may be toggled between Y and N by putting the cursor
  2231.     on it using the Up/Dn Arr keys, and pressing the spacebar or the
  2232.     letter N or Y.  When you have reconfigured the way you wish, press
  2233.     Enter. Esc exits with no changes. Here is an explanation of each
  2234.     feature:
  2235.  
  2236.       1.   In keeping with the convention most often used by other
  2237.     programs, the F1 key is assigned as a "Help" call in the editor and
  2238.     tree modules, and this is the default setting for the main module.
  2239.  
  2240.                                      1-49 
  2241.       2.   For those who do not wish to use the "soft" delete feature nor
  2242.     be bothered with the ~TRASH~ directory, the D key may be reconfigured
  2243.     to "HARD Delete", identical to Ctrl-D, by resetting this switch to Y.
  2244.  
  2245.       3.   Setting this switch causes all files to be "wiped" (their data
  2246.     overwritten with "cfcfcf . . . ") before deleted with the DOS file
  2247.     delete service, to ensure complete destruction of files.
  2248.  
  2249.       4.   In the default setting, CF does not waste time during file copy
  2250.     operations overcopying any file in the target path that is reported by
  2251.     DOS to be the same date/time and size as a tagged file in the source
  2252.     path. However, sometimes you might want to mass-overwrite files on a
  2253.     backup directory or disk that are suspect, even though they may appear
  2254.     to be identical. Just set the overcopy switch to Y.
  2255.  
  2256.       5.   For Windows users, if you run CF in a window, it does not have
  2257.     any way of knowing when it returns from the background to the
  2258.     foreground whether any other application has written to the
  2259.     directories that it is selected to. In the default setting, it does
  2260.     not refresh the file listing (reread the directory tables). Windows
  2261.     users may want to reset this switch to Y.
  2262.  
  2263.       6. and 7.  The DESCRIPT.ION file, created in each directory as
  2264.     necessary to contain file and sub-directory notes, may be assigned the
  2265.     Hidden and / or Read-Only file attributes for neatness of directory
  2266.     display and / or protection from inadvertent deletion. The default
  2267.     values are No.
  2268.  
  2269.       8. Unless you turn it off, CF will always update the DESCRIPT.ION
  2270.     file when a file with a note is copied into the directory, deleted
  2271.     from the directory, or removed.
  2272.  
  2273.       9.  The automatic Screen Saver may be turned off with this switch,
  2274.     if you have a favorite resident screen saver installed.
  2275.  
  2276.       10.  European users will want to see dates in the form dd-mm-yy in
  2277.     all of CMFiler's displays, and will want to toggle this switch to Y.
  2278.  
  2279.       11. Certain LCD displays invert the action of the high-intensity
  2280.     color bit. If the display is all high-intensity except for the line
  2281.     the cursor is on, try changing the switch to Y.
  2282.  
  2283.       12.  The color attribute set may be changed by pressing C, V, M, T,
  2284.     E or L. If, for example, your system has a color card driving a green-
  2285.     screen monochrome monitor, you probably would be more satisfied with
  2286.  
  2287.                                      1-50 
  2288.     the monochrome color set invoked by M than the default color set C.
  2289.  
  2290.       13.  If you have an EGA or VGA monitor, 43-line and/or 50-line
  2291.     display mode is probably accessible to CMFiler. You may set this
  2292.     variable to 4 or 5.
  2293.  
  2294.       There are other features of CF, particularly in the display options,
  2295.     which you may reset lots of times in process, but which don't need to
  2296.     be recorded permanently each time you change one. For example, I leave
  2297.     the file ordering scheme set at the default value of "1" (straight
  2298.     alphabetical), but sometimes I want to look at files in the order I
  2299.     last modified them. I will temporarily reorder using the Ctrl-O
  2300.     command, but I still want CF to come up with ordering scheme "1" next
  2301.     time I run it.
  2302.  
  2303.       These values are savable. The other in-process option features that
  2304.     are savable are the Compare and Hide mode switches, the resident
  2305.     Kernel size, and the system date/time display on or off. They are
  2306.     saved  1) whenever the Shift-O setup Option menu is exited with Enter,
  2307.     2) whenever the Shift-F10 user-defined application menu (discussed in
  2308.     Chapter 4) is exited with Ctrl-Enter, or 3) by pressing Shift-S (Save
  2309.     options).
  2310.  
  2311.  
  2312.     Help . . .
  2313.  
  2314.       In addition to the two-line mini-help area at the bottom of the
  2315.     screen, a help facility may be summoned on-line at any time in the
  2316.     main module of CF by pressing H or F1.  Arrow or PgUp and PgDn through
  2317.     the help screens, or press the first letter of the keyword you are
  2318.     looking up. For example, to move instantly to the page with
  2319.     information on tagging, press T. Esc exits back to the main screen.
  2320.  
  2321.  
  2322.     Custom Configurations on Networks . . .
  2323.  
  2324.       Different users on a network using a common copy of the CF program
  2325.     files may specify their own .CFG file through an environment parameter
  2326.     CF-CFG. For example, if your configuration file is MY.CFG in the path
  2327.     U:\SETTINGS, include a DOS set command SET CF-CFG=U:\SETTINGS\MY.CFG
  2328.     in the batch file that runs CF for you.
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.                                      1-51 
  2335.     Command Line Parameters . . .
  2336.  
  2337.       CF supports optional command line parameters to specify the initial
  2338.     path for the left panel, right panel, file mask and color set, in the
  2339.     syntax:
  2340.  
  2341.         cf [pathspec1[\mask1] [pathspec2[\mask2]]] [@color]
  2342.  
  2343.     where pathspec1 and pathspec2 are directory specifications to the
  2344.     initial directories to be displayed in the left and right panels,
  2345.     mask1 and mask2 are any valid mask specifications, and color is C, V,
  2346.     M, L, E or T for the CGA/EGA/VGA, monochrome, generic LCD, Epson or
  2347.     Tandy LCD color attribute sets. The masks may be attached to either
  2348.     pathspec or stand alone, but must be of the form "*.ext". The color
  2349.     specification may appear anywhere. Examples of valid command lines
  2350.     might be:
  2351.  
  2352.         cf c:\assembly\*.asm c:\pcw @c
  2353.         cmfiler c:dos @m
  2354.         CF UTILS WP51\*.DOC
  2355.         CMFILER @C *.EXE
  2356.         cf c:\dos\*.com  d:\utils\*.exe
  2357.  
  2358.  
  2359.     Formatting Floppy Diskette . . .
  2360.  
  2361.       Floppy diskettes may be formatted without leaving CF. The command is
  2362.     Shift-M (forMat). Double- and high-density 3.5" and 5.25" formats are
  2363.     recognized. If an existing format is detected, CF requests
  2364.     confirmation to proceed. Diskettes cannot be "unformatted" after this
  2365.     command is used, so be certain the disk contains no valuable files
  2366.     before using. All data sector are overwritten with the format "fill"
  2367.     character hex F6, so, unlike the FORMAT.COM of MS-DOS 5 and later, the
  2368.     CF formatter is good for obliterating sensitive data.
  2369.  
  2370.       This formatter is also called during operation of the floppy filler,
  2371.     if needed, so unformatted diskettes may be used for filling. If the
  2372.     formatter encounters a bad sector on the diskette, it will alert you,
  2373.     and will not complete the formatting. You should simply discard this
  2374.     diskette. (Other formatters mark bad sectors in the FAT table and
  2375.     complete the formatting. NoVaSoft's philosophy is that, with the high
  2376.     quality and low cost of diskettes on the market today, defective media
  2377.     is such a rarity that, when a bad sector is encountered, the diskette
  2378.     should just be discarded as a cheap safety measure.)
  2379.  
  2380.  
  2381.                                      1-52 
  2382.       The formatting routine also places a "boot-through" code on the
  2383.     floppy boot sector.  If you boot your computer with a CF-formatted
  2384.     diskette in the boot preference floppy drive, this boot routine will
  2385.     first check its own integrity, as a rudimentary test of whether it has
  2386.     been infected with a boot sector virus, and then load and transfer
  2387.     boot control to the C drive if it is present.
  2388.  
  2389.  
  2390.     Copying Floppy Diskettes . . .
  2391.  
  2392.       A built-in diskette copier is accessible with the command Shift-K (
  2393.     for disKopy). Double- and high-density 5.25" and 3.5" floppies are
  2394.     recognized. You specify hard drive to store master diskette image on,
  2395.     drive to make copies on, number of copies to make and whether each
  2396.     track should be verified as it is written. Number of copies left to go
  2397.     in the batch is displayed after each successful copy.
  2398.  
  2399.       If disKopy encounters a bad sector while formatting or writing the
  2400.     copy, it will alert you that the diskette is bad, and not complete the
  2401.     copy. As discussed above, you should simply discard this diskette.
  2402.  
  2403.       The disKopy facility allows a diskette image to be saved as a file
  2404.     on your hard disk for reuse. After the diskette is read, CF asks if
  2405.     you wish to save it on the designated hard drive. If you answer Y, you
  2406.     will be asked to provide a file specification for the saved file. You
  2407.     may enter a full file spec with path, or put the file on the current
  2408.     directory selected on the hard drive by typing in just a file name.
  2409.  
  2410.       The saved image file may be used to create more diskettes. When you
  2411.     press Shift-K, CF first asks if you want to use an image file to
  2412.     create the diskette copy. If you answer Y, CF seeds the entry line
  2413.     with the name of file that the cursor is on. This gives you a handy
  2414.     way of reusing a diskette image file: just put the cursor on the name
  2415.     of the image file, press Shift-K, then Y, then Enter to accept the
  2416.     seeded file name.
  2417.  
  2418.  
  2419.     Scanning a Diskette Sector-By-Sector . . .
  2420.  
  2421.       You can look at the absolute contents of a diskette with the scan
  2422.     facility, Shift-A (for scAn). Apparently empty diskettes may contain
  2423.     all sorts of interesting information, because the DOS file delete does
  2424.     not obliterate the data, just reallocates the clusters via the File
  2425.     Allocation Table.
  2426.  
  2427.  
  2428.                                      1-53 
  2429.     Quitting CF . . .
  2430.  
  2431.       There are two commands for exiting CF: Esc followed by another key,
  2432.     and Alt-Q. The Esc-other key combination reestablishes the default
  2433.     drive and its current directory as CF found them. The Alt-Q
  2434.     combination leaves the default drive and its current directory as it
  2435.     appears in the source panel. In either case, if you were printing a
  2436.     file, you will be asked if you really want to quit, since the print
  2437.     spooler does not stay resident and quitting will terminate file
  2438.     printing. You may answer N.
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.                                      1-54 
  2476.  
  2477.  
  2478.     CMFiler Ver 6.0
  2479.     ~~~~~~~~~~~~~~~
  2480.  
  2481.  
  2482.     TUTORIAL - Chapter 2: File Viewing and Editing:
  2483.     ____________________ 
  2484.  
  2485.       CF has a built-in colorized line editor, which simplifies file
  2486.     viewing and editing - even .COM and .EXE files.  Since it is part of
  2487.     the package, there is no loading delay.  It is ready when you are.
  2488.  
  2489.  
  2490.     Viewing a File . . .
  2491.  
  2492.       Want to see what's in a file?  Put the cursor on a file and press
  2493.     Enter.  CF loads the selected file in memory for viewing.
  2494.  
  2495.       If the file is a .COM or .EXE file, CF asks if you want to execute
  2496.     the file instead of view it. Press N. If the file is a .ZIP, .LZH,
  2497.     .ARJ, .ARC, .BIN or .EXE compressed file, the editor will first search
  2498.     for and display the names of all the files in the compression. Pick a
  2499.     text file and not a compressed or executable file for this exercise.
  2500.  
  2501.  
  2502.     Record Delimiters . . .
  2503.  
  2504.       The default color display mode for "record delimiters" [carriage
  2505.     return (CR), line feed (LF), and the combinations CR+LF and LF+CR] is
  2506.     to show their color values, which are cued in the legend at the bottom
  2507.     (blue=CR, green=LF, cyan=CR+LF, magenta=LF+CR). In addition, the end
  2508.     of the file is denoted with a red End-of-File (EOF) mark. Sometimes it
  2509.     is very useful to know exactly what delimiter combination your word
  2510.     processors use, so you can duplicate it when you edit with CF. You can
  2511.     toggle the colored delimiter symbols off and on with Alt-Minus or the
  2512.     gray minus key. (This is also covered in a help screen you can get by
  2513.     pressing Alt-H or F1.)
  2514.  
  2515.  
  2516.     Information Area . . .
  2517.  
  2518.       The name of the file being viewed is shown in the lower left prompt
  2519.     area.  The lower right prompt area shows the ASCII value of the
  2520.     character at the cursor (decimal and hex), the position of that
  2521.  
  2522.                                      2-55 
  2523.     character in the file (starting with 1), the line (called "record")
  2524.     the cursor is on, and the position of the cursor within the line
  2525.     (called "Column", which for a long record is not necessarily the same
  2526.     as the screen column).  This information display may be toggled off
  2527.     and on with Alt-Plus or the gray plus key.
  2528.  
  2529.       When the modifier key Alt- or Ctrl- is pressed, this information
  2530.     area displays the block, navigation and special editing commands
  2531.     enabled by the modifier key.
  2532.  
  2533.  
  2534.     Line Wrapping . . .
  2535.  
  2536.       The default display mode is line wrapping, where any line longer
  2537.     than 80 characters is wrapped to the next screen line, so that all
  2538.     text is visible.  This mode can be toggled between "Wrap" and "No
  2539.     Wrap" (see the Wr/NW at upper right for current status) with Alt-W.
  2540.     In the NoWrap mode, each line longer than 80 characters simply extends
  2541.     off the screen to the right, but is accessible for viewing by putting
  2542.     the cursor on it and [Ctrl- or Shift-] Rt Arrow-ing (see below) to any
  2543.     place on the line.
  2544.  
  2545.  
  2546.     Cursor Movement . . .
  2547.  
  2548.       The arrow keys, either on the cursor keypad or numeric keypad, move
  2549.     the cursor one line up or down and one character left or right. Ctrl-
  2550.     Left/Rt Arrow move left or right one word at a time, and Shift-Left/Rt
  2551.     Arrow and Home/End move to the beginning or end of the line, as in
  2552.     PCWrite. A second press of the Home/End key moves to the top/bottom of
  2553.     the page, and a third press moves to the beginning/end of the file
  2554.     contents in memory.
  2555.  
  2556.       PgDn/PgUp moves the display up or down one page frame (20, 38 or 45
  2557.     lines), and leaves the cursor on the same relative video line. Ctrl-
  2558.     PgUp/PgDn moves the display by 10 page frames for fast paging through
  2559.     a file. Shift-Up/Down Arrow moves to the top/bottom of the current
  2560.     page. Alt-B/E moves to the Beginning/End of the file contents in
  2561.     memory.
  2562.  
  2563.       The mouse moves the cursor similar to the arrow keys. A special
  2564.     mouse feature allows variable speed scrolling as well. Hold the right
  2565.     button down and move the cursor down a little bit. The file begins to
  2566.     scroll slowly up the screen. Move the mouse down a little more and the
  2567.     scroll rate increases, through a total of four speeds. Moving the
  2568.  
  2569.                                      2-56 
  2570.     mouse up reverses the direction.
  2571.  
  2572.       For very long files, exceeding available memory, the editor loads
  2573.     only as much as fits. When you get to the end of that section (i.e.,
  2574.     the current "file contents in memory" referred to above), the next
  2575.     operation that asks for another page or line causes the editor to load
  2576.     in the next section, remembering the file position of the start of the
  2577.     previous section so it can backtrack if you want. (It actually loads
  2578.     the next section with some overlap to the previous section, so that a
  2579.     little bit of backtracking does not result in reloading the whole
  2580.     previous section.) This "heel-and-toe" sequential loading is limited
  2581.     to 50 sections.
  2582.  
  2583.  
  2584.     Find a String . . .
  2585.  
  2586.       Want to look for a particular word or string of characters?  The key
  2587.     combination Alt-F (for "Find") opens up a data window at the bottom
  2588.     for you to enter a short string.  The data window is seeded with the
  2589.     word the cursor is on. The previous entry can be recalled with the
  2590.     UpArrow. After you press Enter, CF will find the first appearance of
  2591.     the string from the current cursor position, and put the cursor on it.
  2592.     Alt-X (for "neXt") finds the next appearance, and can be used
  2593.     repeatedly until the string no longer appears, which is signalled at
  2594.     the bottom of the screen. The search process starts at the cursor
  2595.     location and goes, if necessary, to the end of the current file
  2596.     contents in memory.
  2597.  
  2598.       If the file is long and is being viewed by the editor module in
  2599.     sections as discussed above, only the current section in memory is
  2600.     available to the Find operator.  The search is case-insensitive.
  2601.  
  2602.       If the cursor is placed on a word that you want to find the next
  2603.     appearance of, a quick search mode is available by pressing Ctrl-G. CF
  2604.     locates the next appearance of that word (all the text between "white
  2605.     spaces"), even if it has to recycle to the beginning of the file.
  2606.  
  2607.  
  2608.     Leading and Trailing Blanks in the Data Window . . .
  2609.  
  2610.       The data entry routine truncates leading and trailing blanks, but
  2611.     blanks may be included as leading or trailing characters by enclosing
  2612.     the string at either or both ends with quotes (") Suppose, for
  2613.     example, you wanted to find all of the appearances in a file of the
  2614.     word "mark", but not "remark". Press Alt-F and, in the data entry
  2615.  
  2616.                                      2-57 
  2617.     window enter: Find string: >" mark               <.  This works for
  2618.     the replace string as well.
  2619.  
  2620.  
  2621.     Editing a File . . .
  2622.  
  2623.       Exit view mode with either Esc or Enter. The mouse left button is
  2624.     the same as Enter. (Note that any tags in the source panel are still
  2625.     there.) Now you are ready to edit!  Position the cursor on a file that
  2626.     you have an extra copy of somewhere, and press E (for Edit). CF again
  2627.     loads the selected file, but this time with an internal "switch" set
  2628.     which tells the editor module to support editing. (Or, in View mode,
  2629.     press Alt-S, for "Switch to edit".)
  2630.  
  2631.  
  2632.     Edit Mode Limitations . . .
  2633.  
  2634.       CF permits edit mode only if the file fits all at once into
  2635.     available memory, has fewer than 16,380 records, and (in NoWrap mode)
  2636.     has no record longer than 8190 bytes. CF will revert to view mode if
  2637.     these conditions are not all satisfied.  If you have a lot of memory
  2638.     tied up in resident programs or RAM disk/cache, then you may not be
  2639.     able to edit extremely large files. Chances are, however, that this
  2640.     will never be a practical limitation.
  2641.  
  2642.  
  2643.     Typeover vs Insert . . .
  2644.  
  2645.       Look at the small reverse video box in the upper right corner of the
  2646.     screen.  "T/O" or "Ins", then CF is in edit mode. Toggle between
  2647.     typeover (T/O) and insert (Ins) modes with the Insert key. Typing
  2648.     action is just like any word processor.  In typeover mode, the Bksp
  2649.     key does not pull the text left. This is to avoid unintentionally
  2650.     shortening the file when editing length-sensitive files, such as .COM
  2651.     and .EXE files.
  2652.  
  2653.  
  2654.     Editing a Line . . .
  2655.  
  2656.       You operate on a line at a time, and the "normal" editing keys work
  2657.     - i.e. Bksp, Del, Tab, Shift-Tab, the unmodified and modified arrow
  2658.     keys discussed above, and any ASCII-code keys. To create a new line,
  2659.     just Shift-Arrow to the beginning or end of the current line,
  2660.     depending on whether you want the new line above or below the current
  2661.     one, and hit Enter. This inserts the default delimiter combination,
  2662.  
  2663.                                      2-58 
  2664.     CR+LF, into the text to set up a new line void of text, but ready for
  2665.     you to start typing. The combination Ctrl-Enter gives you a menu
  2666.     screen from which you may select a different record delimiter. Join
  2667.     two lines by deleting the record delimiter at the end of the first
  2668.     line to be joined. Delete a line with Ctrl-Y ("Yank"). Delete from the
  2669.     cursor to the end of the line with Ctrl-D. Delete a word and its
  2670.     associated whitespace with Ctrl-T.
  2671.  
  2672.  
  2673.     More on Record Delimiters . . .
  2674.  
  2675.       On CGA/EGA/VGA monitors, the record delimiter appears as a single
  2676.     colored "blank" character at the end of the line, whether it is
  2677.     actually two characters (e.g., CR+LF) or one (e.g., LF). It may be
  2678.     deleted to join two lines, but not over-struck - it always pushes
  2679.     right, even when you are in typeover mode. The red "End-of-File" (EOF)
  2680.     marker is not actually part of your file, but rather is only a visual
  2681.     aid for you to see where the text ends. When the cursor is on the EOF
  2682.     marker, the "byte number" in the legend corresponds to the number of
  2683.     the next character, if you were to type one. The EOF marker also
  2684.     always pushes right, and cannot be deleted.  The height of the cursor
  2685.     shows the status of the "Caps Lock" switch.
  2686.  
  2687.  
  2688.     Alt-Keypad and Alt-N . . .
  2689.  
  2690.       Any ASCII code from 1 through 255 can be entered from the numeric
  2691.     keypad using the Alt-key modifier. A special combination is provided
  2692.     for ASCII zero ("NULL"), since Alt-Zero is not recognized by any
  2693.     keyboard drivers I have seen.  It is Alt-N (for "Null").
  2694.  
  2695.  
  2696.     Changing Case . . .
  2697.  
  2698.       Pressing Ctrl-U/L/I on a letter forces it into upper or lower case,
  2699.     or inverts the case.
  2700.  
  2701.  
  2702.     Pop-Up ASCII Table . . .
  2703.  
  2704.       Ctrl-A pops up a convenient table of ASCII symbols for use in file
  2705.     editing. Just navigate to the symbol you want with the arrow keys or
  2706.     mouse, and press Enter to insert the symbol into the text.
  2707.  
  2708.  
  2709.  
  2710.                                      2-59 
  2711.     Block Operations . . . or the REAL Power of CF's Editor . . .
  2712.  
  2713.       All the block operations - there are six - are keyed to Alt-key
  2714.     combinations, and they are all intuitive (sort of). They are: Alt-{
  2715.     Mark, Yank (delete), moVe, Copy, Print and Output }.
  2716.  
  2717.  
  2718.     Marking a Block, and the Copy Buffer . . .
  2719.  
  2720.       You may also manipulate blocks of lines. First mark a block by
  2721.     putting the cursor on the first (or last) line of the block you want
  2722.     to do something with, press Alt-M (for "Mark"), move down (or up) with
  2723.     arrows, PgDn/Up, etc., and mark the last (or first) line of the block,
  2724.     again with Alt-M. The marked text is written into a dedicated internal
  2725.     copy buffer for later use. If you made a mistake, a third press of
  2726.     Alt-M clears the marks, but leaves the copy buffer intact. The
  2727.     contents of this copy buffer remain available for multiple use until a
  2728.     new block is marked. You may exit the editor back to the main module,
  2729.     and edit another file, and because the editor copy buffer is a
  2730.     dedicated chunk of RAM in the main and editor modules, the buffer is
  2731.     still intact.  Just copy it into the next file with Alt-C.
  2732.  
  2733.       When you are marking a block, note that the information box at the
  2734.     bottom left of the screen expands to show you the attributes of the
  2735.     marked block - the number of the first and last records marked, and
  2736.     the number of bytes in the painted area. There is an arbitrary 32 KB
  2737.     limit on the copy buffer. The upper right-hand information box shows
  2738.     "Blk" (for "blocked") instead of "T/O" or "Ins", meaning that normal
  2739.     editing is not permitted while you have a block marked.
  2740.  
  2741.  
  2742.     Delete, Copy, Move . . .
  2743.  
  2744.       Delete the block with Alt-Y ("Yank"). Or put the cursor in an
  2745.     unpainted area of the file, and copy the block into that area, just
  2746.     ahead of the line where you put the cursor, by pressing Alt-C
  2747.     ("Copy"). Or move it with Alt-V ("moVe"). As noted above, the block
  2748.     previously "marked" into the copy buffer is available for multiple
  2749.     use.  Just put the cursor where you want the block to be copied and
  2750.     hit Alt-C again.
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.                                      2-60 
  2758.     Restoring from Inadvertent Block Deletion . . .
  2759.  
  2760.       If you just deleted a block in error, put the cursor where you want
  2761.     to restore it, and press Alt-C to copy the buffer back into the file.
  2762.  
  2763.  
  2764.     Sending a Block of Text to the Printer . . .
  2765.  
  2766.       Print the copy buffer to the parallel printer with Alt-P ("Print").
  2767.     After printing, if you want a form feed, press Ctrl-F ("Form feed" -
  2768.     note the use of Ctrl- vice Alt- as the modifier key, since Alt-F was
  2769.     already used for "Find").
  2770.  
  2771.  
  2772.     . . . or to a File . . .
  2773.  
  2774.       Finally, output the copy buffer to a file in the same path as the
  2775.     file being edited by pressing Alt-O (letter "O" for "Output"). A
  2776.     window opens at the bottom for typing the name of the file for CF to
  2777.     create (if it doesn't already exist) or append to if it does. (The
  2778.     file will be created or opened in the current directory on the default
  2779.     drive. Therefore the characters ":" and "\" will not be recognized.)
  2780.  
  2781.  
  2782.     Replace and Global replace . . .
  2783.  
  2784.       In addition to the Alt-F "find" feature, there is an Alt-R "replace"
  2785.     and an Alt-G "global replace" feature. Just press Alt-R or Alt-G and
  2786.     enter the find and replace strings when prompted. (If you see a
  2787.     mistake in the find string while you are typing the replace string,
  2788.     just arrow back up a line and reedit it.) For Alt-R, CF will find the
  2789.     first match and ask you to confirm the replacement. It continues
  2790.     finding and requesting confirmation until you press Q (for "Quit
  2791.     replacing") or Esc. Alt-X reactivates either the find or replace
  2792.     routine, whichever was used last. Alt-G replaces all appearances of
  2793.     the find string with no confirmation. It may be terminated with any
  2794.     key press. When global replace is thus terminated, Alt-X reactivates
  2795.     the confirmatory replace, not the global replace.
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.                                      2-61 
  2805.     Leaving Edit Mode . . .
  2806.  
  2807.       After editing is complete, press Esc. When leaving the editor after
  2808.     editing an existing file, there are several decisions you have to
  2809.     make: 1) under what name to save the edited file; 2) whether to use
  2810.     the current date/time or the original date/time of the edited file as
  2811.     the save-file's date/time stamp; 3) whether to rename the original
  2812.     file so it is also saved; and 4) whether to return to the editor after
  2813.     the save operation.
  2814.  
  2815.       The default selections for these options - the ones most often used
  2816.     - are: 1) save the edited file under the original file's name; 2) do
  2817.     not reuse the original date/time stamp; 3) do not rename and save the
  2818.     original file; and 4) do not return to the editor. You can accept
  2819.     these default options by pressing Enter, or Y, or if you had hit Esc
  2820.     by mistake, you can press Esc again to return where you were in the
  2821.     editor. If the defaults are not acceptable, press N, and CF will take
  2822.     you through each option.
  2823.  
  2824.       In the first option, CF offers the original file name as the save-
  2825.     file name, but you can edit it, including adding a path to have it
  2826.     saved in a different directory. If you do not want to save the edited
  2827.     file at all, press Esc.
  2828.  
  2829.       In the second option, you may press Y to reuse the original
  2830.     date/time stamp of the file that was edited.
  2831.  
  2832.       In the third option, CF offers a default name to rename the original
  2833.     file, replacing the last character of the extension with an
  2834.     exclamation point. You can edit the name, or press Esc to avoid
  2835.     renaming the original file.
  2836.  
  2837.       In the fourth option, you may press Y to return to the editor.
  2838.  
  2839.  
  2840.     Saving File in Mid-Session . . .
  2841.  
  2842.       The command Ctrl-S lets you save a file in mid-session while
  2843.     editing. This is prudent during a long session just to make sure you
  2844.     don't lose the edit to a power failure. Ctrl-S provides a sequence and
  2845.     defaults similar to the exit sequence above except that you return to
  2846.     the editor instead of leaving.
  2847.  
  2848.  
  2849.  
  2850.  
  2851.                                      2-62 
  2852.     Creating a New File with the Editor . . .
  2853.  
  2854.       A new file may be created from the main module by pressing the
  2855.     letter F ("new File") and entering a name for the new file in the data
  2856.     entry line. The new file will appear in the directory from which the F
  2857.     command was issued.
  2858.  
  2859.  
  2860.     Help . . .
  2861.  
  2862.       A  help facility may be summoned on-line at any time in the editor
  2863.     with the command F1 or Alt-H.  Operation is identical to main module.
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.                                      2-63 
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.     TUTORIAL - Chapter 3: The TREE Functions:
  2906.     ____________________
  2907.  
  2908.       CF lets you view and operate on the subdirectory structure of your
  2909.     disk in the format of a "tree", so-called because that is what it
  2910.     looks like, with each subdirectory being a "limb" for the finer
  2911.     "branches" in its substructure. This feature is invoked with the
  2912.     command Shift-T (for "Tree"). The command conventions in the tree
  2913.     module are the same as you have encountered in the main screen, except
  2914.     on a much smaller scale.
  2915.  
  2916.       The path(s) on entry are preserved from the main screen, and the
  2917.     selected subdirectory structure in the source panel is highlighted as
  2918.     a block. This source block may be copied, moved or (with great
  2919.     caution) deleted. A fast machine can wipe out a lot of files in a big
  2920.     hurry, and because of this I have added a second confirmation of any
  2921.     delete operation that involves file destruction.
  2922.  
  2923.  
  2924.     Tree Image Facility . . .
  2925.  
  2926.       In Version 6, the tree module has a feature that captures to a
  2927.     subdirectory ~TREES~ (which CF creates for this purpose) an image file
  2928.     of the tree and of its filenames for each drive when that drive is
  2929.     first accessed.  These image files are then available for use as a
  2930.     quick alternative to rereading the whole drive the next time the tree
  2931.     module is entered and that drive is selected.  The image files load
  2932.     the tree structure in a fraction of the time it takes to read the
  2933.     whole drive and construct the directory and file lists.  The ~TREES~
  2934.     directory will be created on the path in the configuration environment
  2935.     parameter CF-CFG, if one has been specified by a SET command.
  2936.     Otherwise it will be created on the root of C.
  2937.  
  2938.       The first time Version 6 is run in tree mode, CF explains three
  2939.     basic setup options to help the user use this new feature in the best
  2940.     way.  In one option, you can tell CF to ask permission to reread the
  2941.     drive and refresh the tree image on file after copying a structure
  2942.     into the drive tree. It is often convenient, if you have several
  2943.     structures to copy, to wait until the last before rereading the drive
  2944.  
  2945.                                      3-65 
  2946.     and refreshing the tree image.
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.                                      3-66 
  2993.       The tree image can also be manually updated using Shift-R (Refresh
  2994.     tree). The tree image option menu can be brought up with Ctrl-O (for
  2995.     image Options).
  2996.  
  2997.  
  2998.     The Display . . .
  2999.  
  3000.       If you entered the tree feature with both panels open, you see that
  3001.     the source/target panel relationship is preserved, and the paths
  3002.     displayed at the top and indicated by the cursor highlights in the
  3003.     tree structure itself are as existed from the main screen. The
  3004.     structure under the cursor in the source panel, namely the selected
  3005.     directory and all its files and subdirectories and their files, is
  3006.     shown as a highlighted block with a bright background, while the
  3007.     current directory selected in the target structure is shown
  3008.     highlighted with a reverse video background.
  3009.  
  3010.       If you entered the tree module with the right-hand panel closed, you
  3011.     may open it the same way as you would from the main screen - right
  3012.     arrow, then press a drive letter at the prompt.
  3013.  
  3014.       Line 1 at the top of the screen gives the status of two display
  3015.     enhancement switches. The "hide" and "compare" switches are passed
  3016.     from the main module, and have the same function. When the hide switch
  3017.     is on (^Hide=Y), subdirectories with the hidden attribute set are
  3018.     masked (i.e., not displayed). When the compare switch is on (^Comp=Y),
  3019.     any match in the target panel to the currently selected path in the
  3020.     source panel will be highlighted in a high-intensity color, similar to
  3021.     the highlighting of file matches in the main screen. The hide and
  3022.     compare switches may be toggled using Ctrl-H and Ctrl-C (shown as ^H
  3023.     and ^C); their states are transmitted back to the main module on
  3024.     return.
  3025.  
  3026.       The "Goto" string also appears on the top line when the Goto file or
  3027.     Goto directory command is given (G or Alt-G). More on that later.
  3028.  
  3029.       Information about the selected structures is contained in the two
  3030.     lines at the bottom of the screen. In each panel, there are two pairs
  3031.     of numbers, one pair for the amount of disk space used by the files in
  3032.     the structure, a second pair for the number of files in the
  3033.     structure.The first number in each pair describes the files in the
  3034.     immediate directory that the cursor is on (think of this as the "root"
  3035.     of the structure), and the second number in each pair describes  the
  3036.     file ensemble in the entire highlighted structure.
  3037.  
  3038.  
  3039.                                      3-67 
  3040.       Cursor movement is much the same in the tree display as in the main
  3041.     screen.  Left/right arrows switch panels, up/down arrows move one line
  3042.     up and down the tree, PgUp/Dn move up and down the tree several lines
  3043.     at a time, Home/End move to the very top or bottom of the tree, and P
  3044.     (for "Parent") moves the cursor up to the directory's parent. Two
  3045.     additional cursor moves are Shift-Up/Dn Arrow, which moves the cursor
  3046.     up or down one directory in the same level; and Shift-Lf/Rt Arrow,
  3047.     which moves the cursor directly across to the match if you are in
  3048.     compare mode and have a path in the target matching the path of the
  3049.     currently selected structure in the source (same feature as in main
  3050.     module).
  3051.  
  3052.       Mouse action is much the same as in the main file services module.
  3053.     Changing disks or drives (Shift-R or N), renaming subdirectories (R),
  3054.     setting the hide attribute for a subdirectory (2), and toggling the
  3055.     hide and compare switches (Ctrl-H and -C) also all work the same as in
  3056.     the file services module, except that no wild cards are permitted in
  3057.     the rename function.
  3058.  
  3059.  
  3060.     Copying structures . . .
  3061.  
  3062.       If you, as I, never previously thought or visualized much about the
  3063.     structure of the data on your hard disk, and never thought in terms of
  3064.     moving around big blocks, the conventions about to be described will
  3065.     take a little getting used to.  However, you will come to find these
  3066.     operations a great convenience.
  3067.  
  3068.       Select in the target panel a path under which you want to replicate
  3069.     a substructure from the source panel. Pick a small structure in the
  3070.     source panel for starters. Now picture the source block that is
  3071.     highlighted in red (if you're in the default color - in reverse video
  3072.     if monochrome) appearing under the top subdirectory  in the shaded
  3073.     area of the target panel. Press C. The structure selected in the
  3074.     source panel is reproduced, subdirectory-by-subdirectory, file-by-
  3075.     file, under the target path.  (One prohibition - CF does not permit
  3076.     copying a structure onto itself.  That is, if you have the same drive
  3077.     selected in both panels, a structure in the source and its host (the
  3078.     subdirectory it originates from) in the target, the command C will be
  3079.     ignored.)
  3080.  
  3081.       This copy operation is good for backing up major structures hard
  3082.     disk-to-hard disk or hard disk-to-floppy. Once a backup structure
  3083.     exists on another medium, you may keep it up to date the same way.
  3084.     Just remember to set the path in the target panel to the host
  3085.  
  3086.                                      3-68 
  3087.     directory of the structure you are backing up. Updating is possible
  3088.     because the file copying and protection convention used in the tree
  3089.     module is the same as that employed in the main program of CF. Namely:
  3090.  
  3091.       o  Files encountered in the target structure with the same date/time
  3092.     stamp and size are presumed identical, and not rewritten, unless the
  3093.     "file overcopy" switch is on.  As with the "hide" and "compare"
  3094.     switches, the current state of the "overcopy" switch is passed from
  3095.     the main to the tree module.
  3096.  
  3097.       o  Files of the same name encountered in the target that are newer
  3098.     than the source, or that are read-only and the source is not, or that
  3099.     are system files, require confirmation to be overwritten.
  3100.  
  3101.       o Files of zero length in the source structure are not allowed to
  3102.     overwrite files in the target. Non-zero-length files in the source
  3103.     structure always overwrite zero-length files in the target of the same
  3104.     name.
  3105.  
  3106.       Copying in progress may be terminated using Esc. Any errors during
  3107.     file copying cause a pause in the tree copy operation, and the user
  3108.     must confirm continuing.
  3109.  
  3110.       The copy function tries to anticipate the disk space required in the
  3111.     target for the structure being copied, and will proceed without delay
  3112.     if it finds there is enough free space on the target disk to assure
  3113.     the completeness of the copy. It does not attempt to check the target
  3114.     path for possible file duplications with the source block and take for
  3115.     credit as "available space" the space occupied by files which will be
  3116.     overwritten. If it senses not enough space to cleanly copy the whole
  3117.     structure, it will alert you to the possibility of an incomplete copy,
  3118.     and ask for confirmation to proceed anyway. Then, as the copy
  3119.     operation proceeds, it checks disk free space before each file is
  3120.     copied. If there is insufficient space for that file, it tells you so,
  3121.     and asks whether you want to try copying the next file. The answer "N"
  3122.     terminates the whole operation.
  3123.  
  3124.       When backing up structures on your hard disk using the tree
  3125.     structure copy function, if the backup floppy is at all tightly
  3126.     packed, you will get this advisory message. If you know there is a lot
  3127.     of file duplication between the source structure and the backup
  3128.     floppy, you may proceed with the copy operation with confidence that
  3129.     all the files will be properly updated.
  3130.  
  3131.       A final word on the copy function, and the move function  discussed
  3132.  
  3133.                                      3-69 
  3134.     below.  The original cursor position in the target panel, which
  3135.     specified the target path for the operation, is reset after the copy
  3136.     or move operation to show the top line of the new structure just
  3137.     created or moved, so that you can see that the copy or move actually
  3138.     took place and check using the information at the bottom of the screen
  3139.     that all the files were reproduced or moved. However, on the next
  3140.     keystroke, the target path is reset again to its original position.
  3141.  
  3142.  
  3143.     The "Copy Into" Function . . .
  3144.  
  3145.       As seen above, the copy function replicates, as a structure under
  3146.     the target directory, the source block. The structure has the same
  3147.     "name" in both cases, meaning that the top line of the block in the
  3148.     source panel is the same as the top line of the replicated structure
  3149.     in the target panel. Another way to view this is that the subdirectory
  3150.     which serves as the "root" of both structures has the same name.
  3151.  
  3152.       While this seems a convenient way to copy structures between two
  3153.     large mass storage devices, as it forces a uniform convention on the
  3154.     naming and construction of the structures themselves, it may not
  3155.     always be the most convenient way to backup structures from a large
  3156.     mass storage device to a smaller one. This sounds very cryptic, so let
  3157.     me try an example. Suppose one of the major structures in your hard
  3158.     disk is a directory under the root, containing all your files
  3159.     pertaining to your word processor. Let's call this directory WORDS. In
  3160.     it are all the program support files (the editor, the printer, the
  3161.     configuration files, etc.), and two subdirectories, NOTES and LETTERS.
  3162.     If you were to copy the structure with WORDS as its "root" to a virgin
  3163.     floppy, the screen would end up looking like this:
  3164.  
  3165.     C:\                                   A:\
  3166.     |-ANYOLD.DIR                     [    |-WORDS
  3167.     |-WORDS        ]     ----------> [      |-LETTERS
  3168.     | |-LETTERS    ]-----|           [      '-NOTES
  3169.     | '-NOTES]     ]
  3170.     '-ZLAST.DIR
  3171.  
  3172.       But suppose you plan to dedicate this floppy exclusively to the
  3173.     backing up of the files in the WORDS structure, and so you really
  3174.     wanted to put the word processor program and its support files into
  3175.     the root directory of the disk in A:, and have the LETTERS and NOTES
  3176.     be directories of the root, not of a directory WORD. That is, you want
  3177.     not to create the unnecessary layer of a directory called WORDS, but
  3178.     you want the A: disk tree to look like this:
  3179.  
  3180.                                      3-70 
  3181.     A:\ <Where the programs and support files are here in the root>
  3182.     |-LETTERS
  3183.     '-NOTES
  3184.  
  3185.       This is where the command "Copy Into" does the job. Just press the
  3186.     letter I instead of C, and the contents of the structure in the source
  3187.     panel block are copied  Into the target directory, instead of being
  3188.     replicated as a new, complete substructure. Because of the subtle
  3189.     difference between the commands C and I, a confirmatory message is
  3190.     displayed on the screen when you use the copy Into command.
  3191.  
  3192.  
  3193.     Moving structures . . .
  3194.  
  3195.       In much the same way, structures may be moved within the same disk
  3196.     with the commands Shift-C (which moves the structure to under the
  3197.     target directory, similar to Copy) and Shift-I (which moves the
  3198.     structure into the target, like Copy Into). The condition for moving
  3199.     is that the target path is not currently the host of the structure
  3200.     selected in the source panel. When the move is within the same disk,
  3201.     it is accomplished using the DOS rename service,  and no copying of
  3202.     any file data itself is performed, just modifications to the directory
  3203.     tables, and so this is a quick way of doing major reorganizations of
  3204.     your hard disk.
  3205.  
  3206.       "Move" (Shift-C) and "move into" (Shift-I) default to straight
  3207.     "Copy" and "copy Into" if different disks are selected in the source
  3208.     and target panels, followed by confirmation to hard delete the source
  3209.     structure. Moving may be terminated with Esc.
  3210.  
  3211.  
  3212.     Copying Just the Files . . .
  3213.  
  3214.       The command J (for  copy Just files) works somewhat like the copy
  3215.     Into command, but copies just the files in the source subdirectory
  3216.     into the target path, and not the subdirectories and their files and
  3217.     subdirectories, etc.
  3218.  
  3219.  
  3220.     Copying Just the Directory Array . . .
  3221.  
  3222.       The command Alt-C is similar to C, but copies just the skeleton of
  3223.     the structure, the directory array and no files, under the target
  3224.     path. Alt-I, similar to I, copies just the directory structure Into
  3225.     the target path.
  3226.  
  3227.                                      3-71 
  3228.     Deleting Structures . . .
  3229.  
  3230.       This is the scariest of all the tree functions, because a couple of
  3231.     false keys and a fast hard disk and you're destroying files real fast.
  3232.     For this reason, I have added a second confirmation step which warns
  3233.     you how many files are about to be destroyed before it starts, and,
  3234.     for hard disks, have used the same "soft" delete convention for the
  3235.     operator D as discussed in Chapter 1 on the delete function in the
  3236.     main module. (If the structure selected consists entirely of empty
  3237.     subdirectories, CF doesn't bother asking for the second confirmation,
  3238.     since directories are a whole lot easier to re-create than files.)
  3239.     Thus, when file destruction is involved, three keystrokes are required
  3240.     to delete a structure - D, Y, and Y - and, for a hard disk, the files
  3241.     deleted will reappear in the ~TRASH~ directory. As in the main module,
  3242.     the alternative "hard" delete function is Ctrl-D.
  3243.  
  3244.       Esc terminates tree deletion in progress. CF deletes all the files
  3245.     in each subdirectory shown in the tree structure - hidden and read-
  3246.     only, as well as normal.
  3247.  
  3248.       The move and delete operations use a routine to remove the (assumed
  3249.     empty) tree structure in the cursor block in the source panel after
  3250.     all the files have been moved or deleted. If there is a hidden
  3251.     subdirectory in this structure, and the hide switch is set to "Y",
  3252.     however, it will not be seen by the file moving or file deleting
  3253.     routines, as well as the directory removal routine, and a strange-
  3254.     looking error message will be returned, namely "Access denied" during
  3255.     directory removal.  This is classic DOSese, at least most of the time,
  3256.     for "there is something still in there." Toggle the hide switch with
  3257.     Ctrl-H and reexamine the remnants of the structure you tried to
  3258.     delete.
  3259.  
  3260.       To save you time, CF does not reread the tree from the disk after a
  3261.     piece has been deleted, but rather marks the image it made in memory
  3262.     of the tree structure to note the part has been deleted and should not
  3263.     be used in drawing the tree. As a consequence, the statistics - files
  3264.     and KB used by the directories above the deleted portion -- will not
  3265.     be accurate.  After several deletes, you can refresh the tree data
  3266.     from disk with Shift-R (Relist).
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.                                      3-72 
  3275.     Delete Just the Files . . .
  3276.  
  3277.       The companion delete operation to the "copy Just files" command is
  3278.     Alt-D - delete just the files in the source subdirectory.  This is a
  3279.     "hard" delete.
  3280.  
  3281.  
  3282.     Show the File List . . .
  3283.  
  3284.       The command S, for "Show files", is the way to get a look at the
  3285.     file names in a subdirectory without leaving the tree environment.
  3286.     This command opens a window in the target panel showing the first 16
  3287.     files in the directory at the cursor in the source panel. You may
  3288.     continue to scroll up are down through the source panel as before, but
  3289.     now the file window changes as you do to show the contents of the
  3290.     current directory. You may do any other operations that involve only
  3291.     the source window, such as toggle the hide mode, make a new directory,
  3292.     delete a portion of the tree, even get a new drive. Two-panel
  3293.     operations such as copy and move are blocked in this mode by the
  3294.     presence of the "Show files" window.
  3295.  
  3296.       To see more than the first 16 files, arrow across with the left or
  3297.     right arrow to the file window and scroll up and down using the
  3298.     up/down arrows, PgUp/PgDn, Home and End, or use the mouse. View or
  3299.     edit the file with Enter or E, as in the main module.  Move between
  3300.     the tree and its file list with the right or left arrow keys. To
  3301.     return to the main module and perform an operation on a file in the
  3302.     file list, press Shift-Enter with the cursor on that filename. CF
  3303.     immediately returns to the main module, to the directory selected, and
  3304.     places the cursor on that file, ready for you to edit, view, execute,
  3305.     copy, etc. Leave the "Show files" mode with Esc or S from either
  3306.     panel.
  3307.  
  3308.  
  3309.     Find (Goto) a File . . .
  3310.  
  3311.       One of the most powerful functions in the tree arsenal is the
  3312.     filename finder.  There are lots of file-finding utilities around, but
  3313.     most of them tell you where a file is by giving you its path which you
  3314.     have to type into a DOS "change directory" command. Cumbersome.
  3315.  
  3316.       CMFiler offers a file finder which gives you an instant visual cue
  3317.     to the directory(ies) containing the file you are looking for. Simply
  3318.     press G (for "Goto file", just as in the main module). A data window
  3319.     opens at the bottom for you to type the name of the file to search on.
  3320.  
  3321.                                      3-73 
  3322.     It supports the "?" and "*" wildcards.  When you type the first
  3323.     letter, the "Show files" list opens in the opposite panel, and both
  3324.     the tree display and file list dynamically adjust to show current
  3325.     matches.  Keep typing until the matches have been narrowed down as far
  3326.     as you need to go, and press Enter or Esc.
  3327.  
  3328.       Assuming there is at least one file that fits that specification,
  3329.     note that several things have happened:
  3330.  
  3331.       o  At least one directory name in the tree is highlighted with a
  3332.     blinking "pip";
  3333.  
  3334.       o  The cursor has automatically repositioned to the topmost
  3335.     subdirectory containing a filename match; and
  3336.  
  3337.       o  All the file matches are listed in alphabetical order at the top
  3338.     of the window, and are also highlighted with the same blinking pip.
  3339.  
  3340.       If you have a long tree structure with subdirectories out of view
  3341.     off the bottom of the panel, you may not see all of the highlighted
  3342.     subdirectories containing file matches. If there are some
  3343.     subdirectories in the tree containing matches but which are off the
  3344.     screen above or below, a flashing "More" will appear at the top or
  3345.     bottom in the tree display. The cursor movement in the "Goto file"
  3346.     mode that lets you quickly position up or down to the next directory
  3347.     containing a file match is Shift-Up/Down Arrow. Use Shift-Up/Down
  3348.     Arrow to navigate to all the directories with a match. Otherwise
  3349.     navigation and services are the same as Show files mode.
  3350.  
  3351.       If there are matching files out of view above or below the file
  3352.     window, a flashing "More" will appear at the top or bottom of the file
  3353.     window frame. Quit "Goto file" mode with Esc, G or Alt-G.
  3354.  
  3355.  
  3356.     Goto a Directory . . .
  3357.  
  3358.       There is also a quick way to navigate to a subdirectory anywhere in
  3359.     the tree that, like the "Goto file" command, mimics a command in the
  3360.     main module. It is Alt-G, and it behaves similarly to G above, except
  3361.     that the file list is not opened in the other panel, and the tree
  3362.     display is changed dynamically to highlight the directory name matches
  3363.     and position on the topmost match. Type the name of the directory you
  3364.     are looking for, and when it has been singled out to your
  3365.     satisfaction, type Enter or Esc. Matches are also highlighted in the
  3366.     target tree, if any exist. Shift-Up/Down Arrow to the next match up or
  3367.  
  3368.                                      3-74 
  3369.     down; otherwise navigation and services are normal. Quit "Goto
  3370.     directory" mode with Esc, G or Alt-G.
  3371.  
  3372.  
  3373.     Find Text . . .
  3374.  
  3375.       Another powerful operation in CMFiler's tree services, to complement
  3376.     the filename finder, is a file text finder. Press Shift-F (Find text).
  3377.     Enter the text to be found (the search is case-insensitive), and then
  3378.     enter up to eight filenames describing the types of files you want
  3379.     included in the search, separated by + signs. The pipe symbol (|,
  3380.     ASCII 124) placed in front of a filename means "do not include this
  3381.     type".  So, for example, the entry:
  3382.  
  3383.     CMFILER.*+|*.COM+|*.OVY+*.TXT
  3384.  
  3385.     would result in a search of all files with the name CMFILER except
  3386.     CMFILER.COM and CMFILER.OVY, plus all files with the extension .TXT.
  3387.  
  3388.       CF's guess at this point on what part of the disk to search is that
  3389.     you wanted to look only in the selected portion of the tree - the
  3390.     structure at and below the cursor. Just to be sure, it asks for
  3391.     confirmation, and will allow you to extend the search to the whole
  3392.     disk if you wish.
  3393.  
  3394.       An option for the text search string is the character "*", which
  3395.     means "accept any text". This is useful, for example, if you wanted to
  3396.     see all the files of several different descriptions in the tree, but
  3397.     didn't want to do each at a time using the filename finder (which only
  3398.     supports one entry), and didn't care what they contained. Suppose you
  3399.     want to see all the executable files on your disk.  Just press Shift-
  3400.     F, enter * as the text, and *.COM+*.EXE+*.BAT as the names to search
  3401.     on.
  3402.  
  3403.  
  3404.     Viewing or Editing Files . . .
  3405.  
  3406.       The editor is accessible directly from the tree module. In either
  3407.     the Show files or Goto file mode, with the cursor in the file list
  3408.     window on a file name, press Enter to view or E to Edit the file.
  3409.  
  3410.  
  3411.     Deleting Files from the File List . . .
  3412.  
  3413.       Another feature in the Show files and Goto file modes that speeds
  3414.  
  3415.                                      3-75 
  3416.     disk cleanup is individual file deletion while the cursor is in the
  3417.     file list. The following commands are available, which mimic commands
  3418.     in the main file services module: Tag (or spacebar) toggles the tag on
  3419.     an individual file; tagAll clears or sets all tags; D soft Deletes
  3420.     file(s) to ~TRASH~ (unless the D key was redefined as hard delete in
  3421.     the main module); and Ctrl-D hard delete file(s) off the disk. This
  3422.     feature gives you a more macroscopic view of your disk while you are
  3423.     cleaning it up.
  3424.  
  3425.  
  3426.     Print a Hard Copy of the Tree or Found Files . . .
  3427.  
  3428.       Except in the Goto file and Find text modes, the command Alt-L (same
  3429.     syntax as in the main module) prints a copy of the tree structure to
  3430.     the parallel printer. In Goto file or Find text mode, however, Alt-L
  3431.     prints an alphabetical listing, organized by directory, of all the
  3432.     files identified by the preceding search. The date, time, disk volume
  3433.     and search parameters are all printed at the top of listing.
  3434.  
  3435.  
  3436.     Precaution Regarding ~TRASH~ . . .
  3437.  
  3438.       The directory ~TRASH~ is not permitted as the source for a copy or
  3439.     move operation. Since this directory contains deleted files, files in
  3440.     this directory may only be moved/copied from the main module, and only
  3441.     after confirmation.
  3442.  
  3443.  
  3444.     Help . . .
  3445.  
  3446.       A help facility like that in the main module may be summoned on-line
  3447.     at any time within the tree module with the command F1 or H.
  3448.  
  3449.  
  3450.     Leaving the Tree Functions . . .
  3451.  
  3452.       There are three ways to leave the tree display. Enter goes back to
  3453.     the main program display, with the path(s) for the left (and right, if
  3454.     open) panel(s) as selected on the respective trees. Esc goes back to
  3455.     the main program with the path(s) set as they were on entry. And
  3456.     finally, Alt-Q has the same convention as in the main program - quit
  3457.     CF altogether, with default drive and current directory as selected in
  3458.     the tree source panel.
  3459.  
  3460.  
  3461.  
  3462.                                      3-76 
  3463.  
  3464.  
  3465.     CMFiler Ver 6.0
  3466.     ~~~~~~~~~~~~~~~
  3467.  
  3468.     TUTORIAL - Chapter 4: Launching User Applications:
  3469.     ____________________ 
  3470.  
  3471.       So far, you have seen the features that make CF useful for file and
  3472.     directory  management - neatness of file display, flexibility in
  3473.     manipulating directories and files, transparency of operation, and
  3474.     even the ability to edit files without leaving the environment of CF.
  3475.     What really makes CF useful as an operating environment, though, is
  3476.     its ability to execute user applications with an economy of
  3477.     keystrokes.
  3478.  
  3479.       Running programs in the DOS environment is one of the more
  3480.     cumbersome and confusing aspects of DOS, and therefore, by its nature,
  3481.     this chapter is not terribly straightforward.  I will make it as
  3482.     simple as I know how.
  3483.  
  3484.  
  3485.     Terminology: User Application as "Child" Program . . .
  3486.  
  3487.       A "user application" is nothing more than a "child" program,
  3488.     executed by the DOS operating system under the command of the "parent"
  3489.     program, which stays resident and waits for the "child" program to
  3490.     finish. When you ran CF from the DOS system prompt, it was as a
  3491.     "child" of the DOS COMMAND.COM command processor. Some word processors
  3492.     permit you to "shell" to DOS, leaving the word processor program code
  3493.     resident in memory. What the word processor program is actually doing
  3494.     is running the DOS COMMAND.COM command processor as a child. From this
  3495.     DOS "shell", you could run yet another program as a child of
  3496.     COMMAND.COM. The more layers of child programs you have at any time,
  3497.     the more RAM you eat up for the currently running program with the
  3498.     resident program code of generations of parents waiting to resume
  3499.     control.
  3500.  
  3501.  
  3502.     Resident Footprint of CF . . .
  3503.  
  3504.       If you use your computer for more than just one task, therefore, you
  3505.     may find CF useful as an "inner shell" of your operating environment.
  3506.     You may let all 156 kb stay resident (the CF.COM kernel plus the
  3507.  
  3508.                                      4-77 
  3509.     CF.OVY overlay) while the child is running, or if you are memory-
  3510.     limited you may force CF to give back to DOS for allocation to the
  3511.     child all but 22 kb for the CF.COM kernel. This option is exercised by
  3512.     pressing K (for "Kernel"), and then pressing either L or S at the
  3513.     prompt (for "Large" or "Small"). "Small" is the initial default
  3514.     setting. This setting is updated to the current option any time the
  3515.     .CFG file is saved.
  3516.  
  3517.       There is a trade-off here. The large kernel option ties up more RAM
  3518.     that could be used by the child if it is a humongous program, but the
  3519.     return to the CF environment after it finishes is instantaneous. The
  3520.     small kernel option is good for freeing the maximum amount of RAM for
  3521.     the child, but there is a small delay in returning to CF while the
  3522.     resident kernel reloads the overlay. With today's hard drives, this
  3523.     delay is hardly noticeable. You be the judge.  The best thing is that
  3524.     you can decide before each launch, if you want, at the cost of only
  3525.     two keystrokes!
  3526.  
  3527.  
  3528.     "Shelling" to DOS . . .
  3529.  
  3530.       You may "shell" to DOS - that is, execute the DOS command processor
  3531.     - any time you want from the main screen just by pressing S. A prompt
  3532.     will tell you to return to CF when you are done by entering the DOS
  3533.     "exit" command. This is the most elemental child process in CF.
  3534.  
  3535.  
  3536.     Review of DOS Command Line Structure . . .
  3537.  
  3538.       Before talking about how CF launches applications, let's review how
  3539.     it's done from the DOS command processor. Say you are in the root of
  3540.     the C drive, and you want to start your PCWrite word processor, which
  3541.     is named ED.EXE and is in a directory called PCW off the root.
  3542.     Further, let's say you want ED.EXE to edit a file called USER.LST in a
  3543.     subdirectory of PCW called DATA.  At the C:\> prompt you could type:
  3544.  
  3545.         C:\>PCW\ED.EXE C:\PCW\DATA\USER.LST
  3546.  
  3547.       What this command tells DOS is: 1) leaving C as the default drive
  3548.     and the root \ as the current directory, go to directory \PCW, find
  3549.     and execute ED.EXE, and pass the string "C:\PCW\DATA\USER.LST" along
  3550.     to it as a "command tail", so it knows what you want it to do.  (The
  3551.     "command tail" is nothing more than everything in the DOS command line
  3552.  
  3553.                                      4-78 
  3554.     after the program specification (in this case PCW\ED.EXE).)
  3555.  
  3556.         C:\>PCW\ED.EXE C:\PCW\DATA\USER.LST
  3557.          |Cprog specD| |C command tail   D|
  3558.  
  3559.       If you have typed a lot of DOS command lines, you know how
  3560.     tedious they can become, particularly if there is more than one
  3561.     parameter in the command tail after the program specification. But you
  3562.     know that most of the time, the one or more parameters in the command
  3563.     tail are filenames or file specifications (filenames with full path
  3564.     specifications in front of them), and sometimes there are parameters
  3565.     the program will use to configure what it does - command line options.
  3566.  
  3567.       The ensuing discussion may be simpler if you think about each step
  3568.     in launching an application from CF as having to do with constructing
  3569.     either the program specification (the first argument in the command
  3570.     line, which tells DOS what program to run), or the command tail (which
  3571.     tells the program what to do once it's running).
  3572.  
  3573.  
  3574.     Launching a Program from the Main Screen . . .
  3575.  
  3576.       You can run any "executable" (.COM, .EXE, .BAT or .BTM) file from
  3577.     CF, as a child program, anytime you want, from the main screen. There
  3578.     are several ways to do it:
  3579.  
  3580.  
  3581.     Immediate Execution . . .
  3582.  
  3583.       This is the quickest way. Just position the cursor on an executable
  3584.     file entry on the screen and press Q (for "Quick execute"), or hit
  3585.     Enter twice, or the mouse left button twice with the arrow symbol
  3586.     highlighted on the mouse bar. This is ideal if the program is located
  3587.     in the same directory as any files it might look for, and it does not
  3588.     need a command tail to tell it what files to operate on or what
  3589.     optional switches to set.  This is just like typing in the name of the
  3590.     program at the DOS command line, once you are selected to the
  3591.     directory containing the program.
  3592.  
  3593.  
  3594.     Execution with Command Tail . . .
  3595.  
  3596.       However, as discussed above many programs expect data in the command
  3597.  
  3598.                                      4-79 
  3599.     tail, such as the name of a file to operate on, and CF has provided
  3600.     several ways of constructing the DOS command line.
  3601.  
  3602.       The simplest is this: First, position the cursor on the file you
  3603.     want to execute and press X (for "eXecute"). This constructs the
  3604.     "program specification" for the DOS command line. A prompt message
  3605.     will tell you this file is ready for execution, its path and name put
  3606.     into a special buffer in RAM, lined up and waiting for the launch
  3607.     command from you to commence execution as soon as you select a
  3608.     "default path" -- the current drive and directory the program will be
  3609.     looking on for its files. Select the default path in either panel,
  3610.     and, with that panel set as the source panel, press Alt-X. A data
  3611.     entry window opens at the bottom, in which you may enter a command
  3612.     tail for the program's use. Enter any file names or other command tail
  3613.     data your application expects, and hit Enter to run.
  3614.  
  3615.  
  3616.     Execution with a Single File Name in the Command Tail . . .
  3617.  
  3618.       The simplest case of the command tail is a single file name. CF
  3619.     offers a shorthand way of running a program with a one-filename
  3620.     argument as the command tail. Put the cursor on the name of the
  3621.     program file you want to run and press X as before. The program is
  3622.     ready to run. Now find the directory containing the file you want this
  3623.     program to operate on, put the cursor on the filename, and press Ctrl-
  3624.     X. It's off and running, editing (or whatever other operation it's
  3625.     doing on) that file. Two keystrokes. Ctrl-X means "add the name of the
  3626.     file at the cursor to the command tail and execute immediately."
  3627.  
  3628.       It is a good idea to have the program file and its supporting files
  3629.     in the same directory as the "operand" files when you use this method
  3630.     of execution, unless the program is smart enough to locate its
  3631.     supporting files in another directory in the DOS path environment.
  3632.  
  3633.  
  3634.     "Seeding" the Command Tail . . .
  3635.  
  3636.       In some cases, the above quick way to specify a one-filename command
  3637.     tail is not enough. You may find a need to put into the command tail
  3638.     the names of several files on the default path, or the full
  3639.     specifications of several files not on the default path, or both.
  3640.  
  3641.       In CF, there are shorthand ways of "seeding" the command tail window
  3642.  
  3643.                                      4-80 
  3644.     with file specifications and filenames. These may be used either
  3645.     before or after readying the program file for eXecution with X.
  3646.  
  3647.       o  To seed the command tail with the full specification (path
  3648.     plus name) of a file on which you want the program to operate, put the
  3649.     cursor on the filename and press Alt-C (the C in this case is a
  3650.     mnemonic for "build Command tail").  The information window at the
  3651.     bottom will show you the command tail in its current state. This
  3652.     procedure may be repeated to build a command tail as long as there is
  3653.     room in the command tail buffer. The command tail is limited by DOS to
  3654.     125 characters.
  3655.  
  3656.       o  Just before pressing Alt-X to show the command tail window
  3657.     for final pre-launch editing, you may normal-Tag or Alt-Tag one of
  3658.     more files in the default path. These file names, without paths
  3659.     specifications, will all appear in the command tail in the order they
  3660.     were Alt-Tagged or in the order listed on the screen if normal-Tagged.
  3661.  
  3662.       Now press Alt-X to open the data window with the seeded command
  3663.     tail.  Once you have edited the command tail the way you want it, hit
  3664.     Enter, and the program is off and running. After the launched program
  3665.     finishes and returns control to CF, its file specification stays in
  3666.     the "execute queue" until you ready another executable file with X, so
  3667.     you may perform multiple runs of the same program just by seeding the
  3668.     command tail again as above, and pressing Alt-X again. As a further
  3669.     time-saving feature, you may recall the previous command tail by
  3670.     pressing the up arrow or PgUp while in the command tail edit window at
  3671.     the bottom of the screen.
  3672.  
  3673.       Once you get used to the above conventions, you will find that in
  3674.     many situations you don't need to edit the seeded command tail, and
  3675.     the key sequence Alt-X-Enter seems cumbersome. For those cases I have
  3676.     included the option Shift-X. Use it after you have seeded the command
  3677.     tail using Alt-C and/or T/Alt-T, and avoid the extra Enter stroke. Its
  3678.     effect is to commence execution of the program with the as-seeded
  3679.     command tail, with no edit.
  3680.  
  3681.  
  3682.     Changing the Command Tail "Seed" Delimiter . . .
  3683.  
  3684.       You probably noticed that there was always a space between multiple
  3685.     entries in the seeded command tails created using the Alt-C and T/Alt-
  3686.     T seeding operators by the procedures above. But what if your
  3687.  
  3688.                                      4-81 
  3689.     application looks for commas as the field delimiters for data in the
  3690.     command tail, instead of blanks? Just press Ctrl-Enter from the main
  3691.     screen to pick from three choices for default command tail field
  3692.     delimiters - space, comma, and semicolon.
  3693.  
  3694.  
  3695.     Customizing Your User Application File Specifications . . .
  3696.  
  3697.       Got a few pet applications that you run more than most?  Save the
  3698.     aggravation of hunting them down and pressing Q or one of the X key
  3699.     sequences each time you run them. You can call them with just a touch
  3700.     of one of the function keys F1 through F9! To set this up, press
  3701.     Shift-F10. You will see a data entry screen that lets you specify up
  3702.     to nine executable file names in the entries "F1 = ", "F2 = ", etc.,
  3703.     and an optional default command line parameters entry for each,
  3704.     labelled "F1 Cmd Line Parms  = ", etc. Further down the page, you will
  3705.     see places for similar entries for compression and extraction
  3706.     utilities, and a bottom entry labelled "Password = ". (You may use
  3707.     this last entry to specify a password which must be entered to get
  3708.     back to the main screen from the screen-saver mode - a handy way of
  3709.     blocking undesired access to your files.)
  3710.  
  3711.       In any "Fn = " data window, just type in the filename, including
  3712.     extension, of an executable file you use frequently. Optionally, in
  3713.     the "Fn Cmd Line Parms =" line, type any frequently used command line
  3714.     parameters that you would like to show up as a default entry in the
  3715.     command tail construction. You do not need to include the path in the
  3716.     file specification if the file is on one of the paths listed in the
  3717.     DOS path environment (via a previous "path" command from the DOS
  3718.     system level) - CF will hunt it down and update its internal record of
  3719.     where that file is, so it doesn't have to hunt the next time you call
  3720.     it. However, if you do include a path specification, be sure it is
  3721.     complete (e.g., "C:\LETTERS\ED.EXE").
  3722.  
  3723.       Once you have made all the entries you wish, press Ctrl-Enter to
  3724.     record the new entries and leave the F-key data entry screen. (Esc
  3725.     will abort the edit.) CF will then find and update the CF.CFG
  3726.     configuration data file to add the customized F-key information.
  3727.  
  3728.       There are three ways to now use these F-key options:
  3729.  
  3730.       o  Press the F-key corresponding to an application you specified
  3731.     with the Shift-F10 operation. (This may be done from either the main
  3732.  
  3733.                                      4-82 
  3734.     screen or the F-key information screen shown by pressing just F10.)
  3735.     You will get the message at the bottom that that  file is readied for
  3736.     execution, just as though you had hunted it down, put the cursor on
  3737.     it, and pressed X. Seed the command tail and set up the default path
  3738.     desired in the source panel as before, and press Alt-X to get the
  3739.     command tail entry window, also as before. This time, though, if you
  3740.     had specified  default command line parameters for this F-key, they
  3741.     would appear in the command tail window, in front of any  seeded
  3742.     entries. Edit the command tail if desired, and press Enter to start
  3743.     execution.
  3744.  
  3745.       o  A nearly equivalent method is to seed the command tail
  3746.     first, set-up the default path, and press Alt-F-Key to ready the
  3747.     program and show the command tail for editing.
  3748.  
  3749.       o  If you know the command tail will be the way you want it,
  3750.     and you are bugged by the extra Enter keystroke to accept the seeded
  3751.     command tail, seed the command tail with Alt-C if you want, set up the
  3752.     source panel to the default directory, Tag/Alt-Tag any files from this
  3753.     directory you want to appear in the command tail, and hit Shift-F-key.
  3754.     The program will run immediately with the seeded command tail, with
  3755.     the default F-key command line parameters between the Alt-C seeds and
  3756.     the T/Alt-T seeds.
  3757.  
  3758.       o  If you are just operating on one file, put the cursor on the
  3759.     name of that file and press a Ctrl-F-key for instant one-key
  3760.     execution. In this case, the F-key default command tail offering will
  3761.     appear in the command tail preceding the name of the file the cursor
  3762.     was on.  (This is the feature I use most.)
  3763.  
  3764.       There is, in fact, a rule as to where the F-key default command line
  3765.     parameters get placed during the construction of the command tail.
  3766.     They are inserted at the point that the F-key itself (or F-key
  3767.     modified by Shift- or Ctrl-) is pressed. The file names Tagged/Alt-
  3768.     Tagged in the current directory always appear last.  In an exotic
  3769.     case, for example, you could: (1) Alt-C a file spec, (2) press F1, (3)
  3770.     Alt-T a file name, and press Shift-X to execute with no edit of the
  3771.     command tail. The program assigned to the F1 key would run, with a
  3772.     command tail consisting of the file spec Alt-C'd in (1), plus the F1
  3773.     default command line parameters, plus the file name Alt-T'd in (3),
  3774.     all separated by the command tail delimiter character last selected
  3775.     from the main screen with Ctrl-Enter.
  3776.  
  3777.  
  3778.                                      4-83 
  3779.       The business above may seem cumbersome, but if you spend a lot of
  3780.     time typing the same old things in at the DOS command processor
  3781.     prompt, you will find it is worth the investment of time to figure out
  3782.     and use.
  3783.  
  3784.  
  3785.     A Further Execution Option - Instant ZIPping/UNZIPping. . .
  3786.  
  3787.       Phil Katz' PKZIP.EXE and PKUNZIP.EXE (c) have become  dominant file
  3788.     compression and decompression programs in the shareware market, so
  3789.     much so that I wrote a special explicit feature to employ them with
  3790.     just a few keystrokes. The commands which invoke these programs from
  3791.     the main menu are Z and U, respectively. CF can find these programs as
  3792.     long as you have not renamed them from PKZIP.EXE and PKUNZIP.EXE, and
  3793.     they are on one of the paths that you specified in a DOS path
  3794.     environment. If for some reason you want to rename them or put them on
  3795.     a path not listed in the DOS path environment, you may specify them
  3796.     explicitly via the Shift-F10 data screen.
  3797.  
  3798.  
  3799.     ZIP a File . . .
  3800.  
  3801.       1.  Decide where you want the compressed file to go, and select that
  3802.     path in one of the panels. If you are updating an existing .ZIP file,
  3803.     Tag or Alt-Tag it while you are there.
  3804.  
  3805.       2.  Now switch to the other panel, and select the path to the files
  3806.     you want to compress. Tag them, or Alt-Tag them in the order in which
  3807.     you want PKZIP to compress them if order is important to you. If none
  3808.     are tagged, CF assumes you want them all to be ZIPped, and puts the
  3809.     command line argument *.* in place of a file list.
  3810.  
  3811.       3.  Now then press Z.  CF will show you a command tail at the bottom
  3812.     of the screen, in the PKZIP syntax (options first, then .ZIP file,
  3813.     then list of files to be ZIPped.)  Since the files to be ZIPped are in
  3814.     the current source path as set up by CF when you Alt-Tagged them, no
  3815.     explicit path is included for them. You may edit the command tail.
  3816.     Once you are satisfied with the command tail, press Enter.
  3817.  
  3818.       [In step 2 above, if you do not Tag or Alt-Tag any files for
  3819.     compression in the source path, CF assumes you want to ZIP them all,
  3820.     and places "*.*" in the file list argument of the PKZIP command tail.]
  3821.  
  3822.  
  3823.                                      4-84 
  3824.       [In step 1 above, if you do not Tag or Alt-Tag a target .ZIP file,
  3825.     CF assigns a default compressed  file name for PKZIP to create, which
  3826.     is either:
  3827.  
  3828.         (1) the first Tagged or Alt-Tagged file in the source path from step
  3829.     2, or;
  3830.  
  3831.         (2) if no source files are Tagged or Alt-Tagged in step 2, the name
  3832.     of the file the cursor is on.  (PKZIP attaches the default .ZIP
  3833.     extension).]
  3834.  
  3835.       [In step 3 above, if you know you don't have to edit the command
  3836.     tail, you can bypass the extra Enter keystroke to enter the command
  3837.     tail by pressing Shift-Z instead of Z.]
  3838.  
  3839.  
  3840.     Now UNZIP a File . . .
  3841.  
  3842.       1.  Set up one panel with the target path for the UNZIPped files.
  3843.  
  3844.       2.  Switch to the other panel, select the path with the .ZIP file to
  3845.     be UNZIPped, and put the cursor on it.
  3846.  
  3847.       3.  Press U, edit the command tail if necessary, and press Enter. As
  3848.     with ZIPping above, if you know you don't have to edit the command
  3849.     tail, press Shift-U instead.
  3850.  
  3851.       The PKZIP/UNZIP utilities are available from most bulletin boards,
  3852.     or may be had for a $47 registration fee from PKWARE, Inc., 9025 N.
  3853.     Deerwood Drive, Brown Deer, WI 53223   (BBS 414-354-8670).
  3854.  
  3855.  
  3856.     Tailoring CF for custom ZIP/UNZIP spec . . .
  3857.  
  3858.       If for some reason you want to specify an explicit path to
  3859.     PKZIP/PKUNZIP, you may include an explicit file specification using
  3860.     the Shift-F10 feature. Just follow the procedure and precautions under
  3861.     "Customizing Your Executable File Specifications" above, and operate
  3862.     on the " Compress = " and "Extract = " fields.
  3863.  
  3864.       If you are familiar with Phil Katz' option switch syntax and find
  3865.     yourself using one or more switches most of the time, you may enter
  3866.     standard options in the indicated fields ("Compress Options =" ,
  3867.  
  3868.                                      4-85 
  3869.     "Extract Options = ") while you are at it.
  3870.  
  3871.       Once you are comfortable using the ZIP/UNZIP feature of CF, and you
  3872.     find you are not having to edit the ZIP/UNZIP command tail most times,
  3873.     you may start getting bugged about having to always hit Enter when you
  3874.     see the command tail displayed. There is an alternative! Just like
  3875.     with the tailored F-keys, hit Shift-Z/U for instant ZIPping/UNZIPping.
  3876.  
  3877.  
  3878.     Using Other Compression Utilities
  3879.  
  3880.       As it happens, some other compression utilities use the same command
  3881.     line construction as the PKWare utilities. Specifically, the ARJ
  3882.     utility by Jung and the LHA utility by Yoshizaki use command lines of
  3883.     the form:
  3884.  
  3885.           archiver options archivefile file1[, file2[ , . . . ] ]
  3886.  
  3887.     where archiver is program spec, options is the collection of commands
  3888.     and switches to accomplish the desired operation, archivefile is the
  3889.     spec to the file which will contain the compressed data, and file1,
  3890.     file2, etc., are the specs of files to be compressed.
  3891.  
  3892.       The CF ZIP/UNZIP facility may be used to accomplish compression and
  3893.     extraction with either ARJ or LHA, and perhaps others as well. Here is
  3894.     how to do it with ARJ as an example:
  3895.  
  3896.       o  Make sure the file ARJ.EXE is on one of the paths specified in
  3897.     your DOS path environment, so that CF can find it.
  3898.  
  3899.       o  In CF, press Shift-F10 to bring up the user-defined applications
  3900.     screen for editing, and down-arrow to the line "Compress = ". Type in
  3901.     ARJ.EXE. Do the same for the line "Extract = ", since for this
  3902.     utility, unlike the PKWare set, the same program does both tasks.
  3903.  
  3904.       o  For the most rudimentary compression and extraction options with
  3905.     ARJ, the only parameter required for the "Compress Options = " line is
  3906.     the letter a, and for the "Extract Options = " line, the letter x.
  3907.     These parameters tell ARJ whether to add (a) or extract (x). Type them
  3908.     in, and press Ctrl-Enter to save the new data.
  3909.  
  3910.       Compressing and extracting now work just the same as previously
  3911.     described for the PKWare utilities. To compress, optionally Tag or
  3912.  
  3913.                                      4-86 
  3914.     Alt-Tag the archive file in one panel, go to the other panel, find the
  3915.     directory with the files to be compressed  (the same path is
  3916.     permitted) and Tag or Alt-Tag them, edit the command tail if necessary
  3917.     and press Enter. To extract, set up one panel with the destination
  3918.     path for the extracted file (may be the same as the source), arrow
  3919.     across to the other panel, put the cursor on the file to be extracted
  3920.     and press U. Edit the command tail and press Enter.
  3921.  
  3922.  
  3923.     Specifying a Password for Access from Screen Saver . . .
  3924.  
  3925.       At the very bottom of the Shift-F10 screen you see a data line for
  3926.     password.  You may enter any combination of alphanumeric characters up
  3927.     to six letters. This password must be given to restore access to CF
  3928.     from screen saver mode. The password routine is case insensitive.
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.                                      4-87 
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.     REFERENCE -- Description by Operation:
  3965.     _____________________________________
  3966.  
  3967.  
  3968.     DISK/DIRECTORY OPERATIONS:
  3969.  
  3970.  
  3971.     N - New drive - Selects a new disk drive for the source panel.  N or
  3972.               Shift-R must be used to announce disk media changes.  In
  3973.               right-hand panel,  Enter after N closes the panel.
  3974.  
  3975.     Ctrl-W - sWap panels
  3976.  
  3977.     Shift-R - Relist panel from disk after media change.
  3978.  
  3979.     Enter - display subdirectory in source panel -  With the cursor on a
  3980.               subdirectory or the "<Parent>" line, changes to that
  3981.               subdirectory or parent in the source panel.
  3982.  
  3983.     Shift-Enter - display subdirectory in target panel - Displays the
  3984.               subdirectory at the cursor in the target panel, and changes
  3985.               to it.
  3986.  
  3987.     P - display Parent directory in source panel - Quick way of returning
  3988.               to the parent directory with the cursor positioned anywhere
  3989.               in the listing of a subdirectory.
  3990.  
  3991.     Shift-P - display source directory's Parent directory in target panel
  3992.               -Quick way of showing the parent of the current directory in
  3993.               the target panel and switching to it.
  3994.  
  3995.     \ - display root directory in source panel.
  3996.  
  3997.     Shift-\ - display root directory of source disk in target panel.
  3998.  
  3999.     Shift-* - display source directory in target panel.
  4000.  
  4001.     Alt-G, followed by a typed string - move cursor to ("Go to...") the
  4002.               directory described by that string.
  4003.  
  4004.     J - Jump to a new directory
  4005.  
  4006.  
  4007.                                         OpRef-89 
  4008.     Alt-1 to Alt-9 - jump to a predefined "alias" path
  4009.  
  4010.     Alt-A - define an "Alias" path
  4011.  
  4012.     M  - Make subdirectory (Mkdir) - With the cursor anywhere in the
  4013.               listing, pressing M opens a data window at the bottom of the
  4014.               screen for entering the name of a new subdirectory you want
  4015.               to make. CF checks the entry for validity; if invalid, the
  4016.               window simply clears and waits for another entry. A valid
  4017.               entry appears in the proper alphabetic position on the
  4018.               screen.
  4019.  
  4020.     D - Delete - With the cursor on a subdirectory and no files tagged,
  4021.               removes that subdirectory if it is empty ("void"). If the
  4022.               cursor is on a subdirectory and files are tagged, deletes
  4023.               the files.
  4024.  
  4025.     Alt-L -  print directory Listing - Prints a listing of the current
  4026.               directory if cursor in directory panel, and includes notes
  4027.               if cursor in one of the Notes modes (Shift-N or Ctrl-N).
  4028.  
  4029.     Shift-T  - transfer control to the Tree module.  Displays the disk(s)
  4030.               selected in the panels in their directory tree structures,
  4031.               and puts the cursor(s) on the structure(s) pointed to by the
  4032.               current path(s).
  4033.  
  4034.     Shift-M - forMat - formats a floppy diskette in drive A or B.
  4035.  
  4036.     Shift-K - disKopy - copies a floppy diskette in drive A or B.
  4037.  
  4038.     Shift-A - scAn diskette in drive A or B
  4039.  
  4040.  
  4041.     FILE OPERATIONS:
  4042.  
  4043.     G, followed by a typed string - move cursor to ("Go to...") file
  4044.               described by that string.
  4045.  
  4046.     Shift-Lf/Rt Arr - Jump across to identical file name in opposite panel
  4047.               when highlighted in comparison mode.
  4048.  
  4049.     T or Space - Tag file - Applies or clears a "normal" tag to the file
  4050.               at the cursor (i.e., toggles the state of the tag). Window
  4051.               at bottom of screen shows number of files tagged.
  4052.  
  4053.     Alt-T or Alt-Space - Alternate-Tag file - Applies or clears an
  4054.               "alternate" (sometimes referred to as "append" because of
  4055.  
  4056.                                         OpRef-90 
  4057.               its principal function) tag to a file.  "Alt-Tags" are
  4058.               numbered (1-9, a-z) to show the order of application, for
  4059.               the order-critical operation of file concatenation,
  4060.               discussed below.
  4061.  
  4062.     A - Tag All files - Applies or clears normal tags to all files.
  4063.  
  4064.     Ctrl-A - toggle the state of All normal tags.
  4065.  
  4066.     Alt-M/E - tag all files with same naMe/Extension as file at cursor;
  4067.               does not reset tags already present.
  4068.  
  4069.     Alt-N - tag all files Newer than file at cursor.
  4070.  
  4071.     Alt-O - tag all files Older than file at cursor.
  4072.  
  4073.     Alt-D - tag all files same Date as file at cursor.
  4074.  
  4075.     Alt-P - tag same files in oPposite panel as tagged in source.
  4076.  
  4077.     (NOTE ON TAGS: Tags are aids for quickly performing multiple file
  4078.               operations, but are "volatile", and generally go away with
  4079.               any operation that changes or updates a panel. Tags are not
  4080.               applied in any way to the magnetic media.)
  4081.  
  4082.     C - Copy - Copies tagged files from source to target, or the one file
  4083.               at the cursor if none tagged. Does not overwrite identical
  4084.               files, asks for verification before overwriting newer files
  4085.               or read-only or system files, and protects against some
  4086.               cases of overwriting good files with files created in error.
  4087.               With files "Alt-Tagged", creates "concatenated" file in
  4088.               target with same name as first "Alt-Tagged" file, but
  4089.               extension ".APF", and permits editing file name. If
  4090.               insufficient room on target  path, does not perform
  4091.               operation, and signals the user.
  4092.  
  4093.     Shift-C - move - Moves files from one subdirectory to another on the
  4094.               same disk. If conditions are not satisfied for moving (i.e.,
  4095.               same disk, different directories), defaults to copy and hard
  4096.               delete.
  4097.  
  4098.     B - Back up - Copies tagged files (or file at cursor if none tagged)
  4099.               from source to source, assigning to each new file an
  4100.               extension consisting of the first two letters of the
  4101.               original extension (! in place of blanks) plus the tilde "~"
  4102.               character. This results in backup files with unique names
  4103.               unless two files differ only in the third letter of the
  4104.  
  4105.                                         OpRef-91 
  4106.               extension..
  4107.  
  4108.     Alt-S - Split a file in source panel into smaller files to target
  4109.               panel
  4110.  
  4111.     D - Delete - Deletes all tagged files on source path. If no files are
  4112.               tagged, deletes only the file at the cursor. Treats normal
  4113.               tags and "Alt-Tags" the same. Requests confirmation before
  4114.               file destruction. On hard disks, this operation is a "soft"
  4115.               delete, in which files are redated to current date/time and
  4116.               moved to directory ~TRASH~ (created by CF). Thus good files
  4117.               inadvertently deleted are readily recoverable. On floppy
  4118.               drives, this operation is a "hard" delete, using the DOS
  4119.               delete file function. "Undeleting" is not available in the
  4120.               CF environment; other utilities contain "undelete"
  4121.               facilities, but these are not always reliable.
  4122.  
  4123.     Ctrl-D - "hard" Delete - Uses DOS delete function regardless of disk
  4124.               type.
  4125.  
  4126.     Shift-F - Freshen files - "Freshens" the files in the source panel
  4127.               from the opposite panel. Useful in updating backup disks. If
  4128.               no files tagged in source, tags all in source, then tags in
  4129.               opposite all newer versions of same-named tagged source
  4130.               files and copies them to source. If any files were tagged in
  4131.               source, only these files are looked for in the opposite
  4132.               panel, vice all files in source.
  4133.  
  4134.     Shift-i - fill floppy disks from source. Fills tagged files (or all
  4135.               files if none tagged) to floppy disks in drive A or B. Disks
  4136.               may be unformatted.
  4137.  
  4138.     R - Rename file or directory - Prints name of file at cursor, and
  4139.               opens window below it for new name, offering the current
  4140.               name as the "seed". Type/edit new name and press Enter. Or
  4141.               first arrow up and edit the current name field, for example
  4142.               to use the "*" wildcard. One use of "*" is permitted (either
  4143.               the name or extension). If used in the current name field,
  4144.               it must be followed in the new name field.  Names are
  4145.               checked for legality before renaming is attempted.
  4146.  
  4147.     Alt-R - copy with Rename -  Copies the one file at the cursor in the
  4148.               source panel to the target, after entry of new name in data
  4149.               window.
  4150.  
  4151.     Enter - display file - With the cursor on a file, views that file.
  4152.  
  4153.  
  4154.                                         OpRef-92 
  4155.     F - make new File - With the cursor anywhere in the listing, pressing
  4156.               F opens a data window at the bottom of the screen for
  4157.               entering the name of a new file to be created. Entry is
  4158.               checked for validity. If valid, control is transferred to
  4159.               the line editor for file creation and editing.
  4160.  
  4161.     0, 1, 2, 3, 4 - toggle file attribute - Pressing the number 0 clears
  4162.               all attributes for any files tagged, or for the file at the
  4163.               cursor if none are tagged.  1 toggles the Read-only
  4164.               attribute, 2 the Hidden attribute, 3 the System attribute,
  4165.               and 4 the Archive attribute.  (Only the number keys at the
  4166.               top of the keyboard are active for setting file attributes.
  4167.               The numbers on the keypad are mapped to their corresponding
  4168.               cursor movement functions, even when the NUM LOCK is set.
  4169.               (The command syntax can be remembered as "1234=-RHSA".)
  4170.  
  4171.     L - print fiLe - Put the file at the cursor into the queue for
  4172.               printing as a background process while in CF or any child of
  4173.               CF. (Printing is suspended during any DOS functions, such as
  4174.               disk read/write.) Up to five files may be thus queued.
  4175.               Shift-L displays the print queue. Ctrl-L clears the print
  4176.               queue. Ctrl-F while files are printing from the print queue
  4177.               sets an internal flag which causes a form feed to the
  4178.               printer at the end of the file most recently added to the
  4179.               print queue if the file itself does not have a form feed as
  4180.               its last character.
  4181.     (At times when the printer is not in use by CF, Ctrl-F sends a form
  4182.               feed immediately.)
  4183.  
  4184.     V - Volume label - Permits entry of a new  volume label for the disk.
  4185.  
  4186.     Shift-O - set user Option switches - Permits the resetting of twelve
  4187.               user-specified option switches .
  4188.  
  4189.     Alt-F - change File date/time stamp.
  4190.  
  4191.  
  4192.     FILE EDITING/VIEWING:
  4193.  
  4194.     Enter -view a file - When the cursor is placed on a file, Enter lets
  4195.               you view the file on the screen.  In this mode, the lower
  4196.               right screen display gives information about the byte the
  4197.               cursor is on. Alt-H displays help screen.  Alt-Plus and Alt-
  4198.               Minus toggle the bottom information display and the color-
  4199.               enhanced display of record delimiters (CR, LF, CR+LF,
  4200.               LF+CR).  Esc or Enter exits View mode. If the file is a
  4201.               compressed format, a list of filenames will first be shown.
  4202.  
  4203.                                         OpRef-93 
  4204.     E - Edit a file -  When the cursor is placed on a file as above, E
  4205.               lets you edit the file.  Cursor positioning is the same.
  4206.               Additional control keys are Bksp, Delete Tab/Shift-Tab;
  4207.               Insert (toggles mode between Insert and Typeover); Enter
  4208.               (inserts the record delimiter previously selected with Ctrl-
  4209.               Enter; default is CR+LF). Ctrl-Y deletes line; Ctrl-D
  4210.               deletes to end of line.  F1 or Alt-H provides a one-page
  4211.               help screen. Block operations are performed with Alt- {M
  4212.               (Mark), Y (Yank), V (moVe), C (Copy), O (Output to file),
  4213.               and P (Print)}. Ctrl-F form-feeds the printer. Enter any
  4214.               ASCII code through Alt-Keypad numerical combinations, except
  4215.               NULL, which is entered by Alt-N.
  4216.  
  4217.  
  4218.  
  4219.     TREE OPERATIONS:
  4220.  
  4221.     Cursor Movement - Up/Down Arrow moves one screen line at a time.
  4222.               PgUp/PgDn moves several lines. Home/End moves to very
  4223.               top/bottom of tree. Shift-Up/Down Arrow moves up/down one
  4224.               directory at same level (to next subdirectory up or down in
  4225.               parent directory), or, in "Goto file", "Goto  directory" and
  4226.               "Find text" modes, to next directory with a match to the
  4227.               find string.  P moves up to parent. Left/Right Arrow changes
  4228.               panels, making the other panel the source. Shift-Left/Right
  4229.               Arrow moves across to the path match in compare mode.
  4230.  
  4231.     N - New drive - Allows changing drives, as in main module.
  4232.  
  4233.     Ctrl-W - sWap panels
  4234.  
  4235.     Shift-R - Relist panel from disk after media change.
  4236.  
  4237.     Ctrl-O - edit tree image Options list
  4238.  
  4239.     M - Make new directory under path at cursor.
  4240.  
  4241.     2 - toggle directory's hide attribute.
  4242.  
  4243.     Alt-L - print a hard copy of the tree Listing shown on the source
  4244.               panel side of the screen in straight tree mode. Prints a
  4245.               listing of all the file matches while in Find file or Find
  4246.               text mode.
  4247.  
  4248.     D - Delete structure - deletes the entire structure highlighted in the
  4249.               cursor block in the source panel.  This is a "soft" delete
  4250.               on hard disks, in which the deleted files are collected in
  4251.  
  4252.                                         OpRef-94 
  4253.               ~TRASH~
  4254.     Ctrl-D - "hard" Delete structure.  Uses the DOS file delete function
  4255.               regardless of disk type.
  4256.  
  4257.     Alt-D - Delete just the file in the source directory.  This is a
  4258.               "hard" delete.
  4259.  
  4260.     C - Copy structure under target path - Replicates the structure in the
  4261.               source panel's cursor block under the directory selected in
  4262.               the target panel.
  4263.  
  4264.     Shift-C - move structure under target path - If both panels selected
  4265.               to the same disk, moves the structure in the source panel's
  4266.               cursor block under the directory selected in the target
  4267.               panel. If different disks selected, defaults to copy
  4268.               followed by hard delete.
  4269.  
  4270.     Alt-C - Copy just the directory array under target directory, no files
  4271.               copied.
  4272.  
  4273.     I - copy structure Into target path - Similar to copy, but does not
  4274.               replicate the highest level subdirectory in the source
  4275.               block, but rather puts its files directly into (vice under)
  4276.               the target subdirectory, and replicates its substructure
  4277.               under the target path.
  4278.  
  4279.     Shift-I - move structure Into target path - Moves the source structure
  4280.               into (vice under) the target subdirectory, as with I.
  4281.  
  4282.     J - copy Just the files in source directory to target directory.
  4283.  
  4284.     Shift-J - move Just the files from the source subdirectory to target.
  4285.  
  4286.     S - Show files in opposite panel. Arrow across to file list if
  4287.               desired, then up/down with normal cursor moves. In file
  4288.               list, Shift-Enter returns to main module, to directory and
  4289.               file selected. Arrow back to tree. Esc or S cancels "Show
  4290.               files". From file list, Enter or E views or edits a file.
  4291.  
  4292.     G - Goto file - Type filename for search.  Wildcards are supported.
  4293.               Positions to first match; directories with matches and
  4294.               matching files are highlighted. Shift-Up/Down Arrow seeks
  4295.               next directory up or down with match.  Arrow across to file
  4296.               list as in "Show files", move up or down, arrow back to
  4297.               tree, or Shift-Enter to file in main module for file
  4298.               operation.  Esc, G or Alt-G to cancel "Goto file" mode. From
  4299.               file list, Enter or E to view or edit a file.
  4300.  
  4301.                                         OpRef-95 
  4302.     Alt-G - Goto directory - Type directory name for search. Navigation
  4303.               within tree and exit are same as G.
  4304.     Shift-F - Find text -  Specify text to search for, and up to eight
  4305.               filenames with wildcards. Directories and files with matches
  4306.               are highlighted.
  4307.  
  4308.     Ctrl-H - toggle the Hide switch and redisplay trees. With switch on
  4309.               (=Y), directories with hidden attribute are not displayed.
  4310.               With switch off (=N), hidden directories are displayed, and
  4311.               are denoted with a highlighted "*H"
  4312.  
  4313.     Ctrl-C - toggle the Compare switch.  With switch on (=Y), target disk
  4314.               is searched for any path that matches that currently
  4315.               selected in source, and, if one is found, adjusts screen if
  4316.               needed so it is visible, and highlights it in high-intensity
  4317.               yellow.
  4318.  
  4319.     Enter - From tree structure, return to main module with currently
  4320.               selected path(s), and cursor positioned to top of listing.
  4321.               From file list in "Show files" or "Goto file" mode, views
  4322.               file. Shift-Enter from file list returns to main module with
  4323.               cursor on file.
  4324.  
  4325.     Esc - Return to main module with path(s) as set on entry.
  4326.  
  4327.     Alt-Q - Quit CF altogether; default path as selected in source.
  4328.  
  4329.  
  4330.     APPLICATION LAUNCHING (CHILD PROCESSES):
  4331.  
  4332.     S - Shell to DOS -  Sets up a DOS shell and do any DOS operations.
  4333.               Exit DOS with the "exit" command when finished. CF then
  4334.               looks for and tries to reestablish the current directories
  4335.               as they appeared in the panels at shell execution.
  4336.  
  4337.     Q - Quick execute - Immediately executes file at cursor, if extension
  4338.               is .COM, .EXE or .BAT. Paths are as selected, ie, default
  4339.               drive/current subdirectory is same as the executable file is
  4340.               in, and the current subdirectory for any other drive is as
  4341.               last set in the panels. Also Enter-Enter
  4342.  
  4343.     X - prepare to eXecute with command line - Readies file at cursor for
  4344.               execution. File remains ready awaiting execution, initiated
  4345.               by one of the followup key combinations Alt-X, Shift-X or
  4346.               Ctrl-X after paths are set and command tail seeded as
  4347.               desired.
  4348.  
  4349.  
  4350.                                         OpRef-96 
  4351.     Alt-X - edit command line and initiate eXecution - Opens a window for
  4352.               editing the command tail containing any "seeds" placed by
  4353.               Alt-C and/or T or Alt-T. Execution of the readied
  4354.               application starts by pressing Enter. The previously used
  4355.               command tail may be summoned by pressing the Up Arrow or
  4356.               PgUp.
  4357.  
  4358.     Shift-X - initiate eXecution, no editing of command tail. Same as Alt-
  4359.               X, except file executes with command tail as-seeded, with no
  4360.               editing. Tagged files in active panel are added to command
  4361.               tail.
  4362.  
  4363.     Ctrl-X - initiate eXecution, no editing of command tail, and only the
  4364.               file name at cursor is added as last entry in seeded command
  4365.               line. Tagged files in active panel are ignored.
  4366.  
  4367.     Alt-C - seed Command tail with file specification. Adds the full
  4368.               specification, including path, of the file at the cursor to
  4369.               the command tail buffer, and shows status of command tail
  4370.               being built. Command tail may be added to using this feature
  4371.               before or after executable file is readied with X.
  4372.  
  4373.     T or Alt-T - Tag the file names in order for addition to the command
  4374.               tail. Tagged files are added to the seeded command tail as
  4375.               the final step after Alt-X or Shift-X is pressed.
  4376.  
  4377.     Ctrl-Enter - select delimiter for use by the "seeding" operations Alt-
  4378.               C and T or Alt-T between entries of command tail. Choices
  4379.               are blank, comma, semicolon.
  4380.  
  4381.     Shift-F10 - specify a user-defined executable file specification and
  4382.               optional default command line offering for up to 9
  4383.               applications, assigned to F1-F9.  Also specify
  4384.               Compress/Extract command line default parameters, and an
  4385.               access password. Ctrl-Enter to record selections in current
  4386.               copy of configuration file, or Esc to cancel edit. Ctrl-
  4387.               Enter also saves the state of all the configurable user-
  4388.               option switches.
  4389.  
  4390.     F10 - Display current entries F1-F9, Compress/Extract options,
  4391.               password. The commands F1-F9, Shift-F1-F9, and Ctrl-F1-F9
  4392.               may all be issued from this display.
  4393.  
  4394.     F1-F9 - ready a user-defined executable file spec -  Effect is same as
  4395.               locating the file with the cursor and hitting X. F-key
  4396.               default command line parameters are added to command tail,
  4397.               which may already have seeded entries.
  4398.  
  4399.                                         OpRef-97 
  4400.     Alt-F1-F9 -- Same effect as F1-F9 followed by Alt-X.
  4401.  
  4402.     Shift-F1-F9 - ready user-defined executable, add its default command
  4403.               line parameters to the command tail being built, add any
  4404.               Tagged files in current directory, and execute immediately.
  4405.               Same effect as F1-F9 followed by Alt-X, Enter.
  4406.  
  4407.     Ctrl-F1-F9 - ready user-defined executable file, add its default
  4408.               command line parameters to the command tail being built, add
  4409.               only the file name under the cursor, and execute
  4410.               immediately.  Tagged files in active panel are not added to
  4411.               the command tail before execution.
  4412.  
  4413.     Z - Compression -  Be sure PKZIP.EXE or other compression utility is
  4414.               on one of the paths in your DOS path command, or specify the
  4415.               complete path spec to it using Shift-F10.
  4416.  
  4417.     To ZIP, select in one panel a target path for the compressed .ZIP
  4418.               file, and optionally Tag or Alt-Tag an existing .ZIP file.
  4419.               Then switch to the other panel and select a source path,
  4420.               optionally Tag or Alt-Tag files to compress in order of
  4421.               desired appearance on command line, press Z, edit command
  4422.               line if necessary, and press Enter. To avoid this extra
  4423.               Enter keystroke, hit Shift-Z instead.
  4424.  
  4425.     U - Extraction - As above, be sure PKUNZIP.EXE or other extraction
  4426.               utility is on a path set in your DOS path command, or
  4427.               specify the complete path spec to it with Shift-F10.
  4428.  
  4429.     To UNZIP, select in one panel a target path for the extracted files,
  4430.               switch panels, select the directory with the .ZIP file to be
  4431.               extracted, place the cursor on it, and press U. Edit command
  4432.               line, if necessary, and press Enter. Alternatively, for
  4433.               instant UNZIPping, use Shift-U.
  4434.  
  4435.  
  4436.     DISPLAY ENHANCEMENT FEATURES:
  4437.  
  4438.     "+" and "-" - Shift the file size display to expanded and contracted
  4439.               mode.  Expanded mode shows explicit size, but uses the file
  4440.               attribute field.  Contracted mode is in KB or MB.
  4441.  
  4442.     H - Help - Help facility.
  4443.  
  4444.     Ctrl-N - edit Notes - Displays the directory notepad in the opposite
  4445.               panel for viewing/entering/editing narrative comments about
  4446.               files. Pulls in Win95 long filenames as notes if not alrealy
  4447.  
  4448.                                         OpRef-98 
  4449.               in DESCRIPT.ION. All the editing and cursor control key
  4450.               combinations work.  Notes follow the files around when
  4451.               copied. CF updates the file on exit (Ctrl-Enter or Esc).
  4452.               Files may be viewed/edited from the Notes screen with Alt-
  4453.               V/Alt-E, tagged with Ctrl-T or Alt-T for subsequent mass
  4454.               action after exit from edit Notes.
  4455.  
  4456.     Shift-N - view Notes - Displays Notes in opposite panel, but leaves
  4457.               full access to all directory and file services in the source
  4458.               panel, including commands like Copy which operate to the
  4459.               target path. Also pulls in Win95 long filenames as notes.
  4460.  
  4461.     Ctrl-O - select file Ordering mode - Permits selection of one of nine
  4462.               modes of file ordering.  Highlight shows current selection.
  4463.  
  4464.     Ctrl-H - toggle Hide switch - Changes the state of the hide-enable
  4465.               switch, shown at the top of the screen. With the switch on
  4466.               ("Y" for Yes), CF does not display files whose hide
  4467.               attribute is set.  With the switch off ("N" for No), all
  4468.               files are shown.
  4469.  
  4470.     Ctrl-C - toggle Compare switch -- Changes the state of the compare-
  4471.               enable switch. In compare mode ("Y"), any file in the target
  4472.               path whose name is the same as the file in the source path
  4473.               under the cursor will be shown and highlighted.
  4474.  
  4475.     Ctrl-M - Mask - Allows editing the Mask template for the panel, whose
  4476.               initial value is *.* Tab moves cursor to the extension
  4477.               field, Shift-Tab to the name field. Press Enter to enter the
  4478.               template modification and redisplay the panel.
  4479.  
  4480.     5 - toggle date/time display on main screen.
  4481.  
  4482.     Ctrl-P - color Palette selection - allows user to change color scheme
  4483.               to any of four sets on color monitors. A palette may be
  4484.               edited by pressing E.
  4485.  
  4486.     Ctrl-E - alphabetic casE selection - Offers a choice of four case
  4487.               conventions: dirs and files all caps; dirs in caps, files in
  4488.               lower; all in lower, and "modified-Tauck", where the first
  4489.               letter of the file and each letter following a non-
  4490.               alphabetic character is capitalized.
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.                                         OpRef-99 
  4498.     MISCELLANEOUS:
  4499.  
  4500.     Shift-O - set up user Options.
  4501.  
  4502.     Alt-I - specify filename for antivirus software Integrity data files.
  4503.               CF protects these files during copy operations. Default is
  4504.               Integrity Master's ZZ##.ID.
  4505.  
  4506.     Alt-Q or Esc-other key - Quit CF - Terminate to DOS. Esc-other key
  4507.               reestablishes the default drive/directory CF encountered on
  4508.               execution; Alt-Q leaves as currently set in source panel.
  4509.  
  4510.     Password Protection - Bottom entry in Shift-F10 screen is a password
  4511.               entry window. If a password is entered, it must be given to
  4512.               return to main screen from the screen-saver mode.
  4513.  
  4514.     Ctrl-S - forces main screen into Screen-saver mode immediately, rather
  4515.               than waiting 1-1/2 minutes. Good for instantly invoking
  4516.               password protection.
  4517.  
  4518.     Shift-S - Save display options. Saves current values of all user
  4519.               configuration options, such as Hide and Compare switches,
  4520.               file Ordering scheme, resident Kernel size selection and
  4521.               date/time display on/off.
  4522.  
  4523.     Ctrl-F - Form feed parallel printer at LPT1.
  4524.  
  4525.     Ctrl-2 - Form feed parallel printer at LPT2.
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.                                        OpRef-100 
  4547.